Instala ownCloud Infinite Scale con Docker Compose

Para la instalación en un servidor, comience con ocis_fullel ejemplo oficial de Docker Compose de ownCloud para la versión estable 8.2. Incluye el servicio Infinite Scale, un proxy inverso y servicios opcionales de colaboración de oficina; configure sus dominios, remitente SMTP y rutas de datos en su .envarchivo antes de ejecutarlo docker compose up -d. Esta configuración está diseñada para una sola instancia y requiere DNS público y puertos accesibles para certificados Let's Encrypt de confianza. Para una evaluación interna sin dominio, siga la limitación de certificados autofirmados que se describe a continuación.

Antes de instalar

Este procedimiento sigue la guía de producción de ownCloud Infinite Scale 8.2 Compose , revisada el 9 de octubre de 2026. La guía está dirigida a Ubuntu LTS 24.04 o 22.04 con Docker Engine y Docker Compose ya instalados. Recomienda al menos 4-6 GB de memoria. Los servicios habilitados por defecto requieren aproximadamente 2,4 GB de espacio en disco, sin tener en cuenta los archivos de usuario, los registros, las copias de seguridad y el crecimiento futuro.

Elija este ejemplo completo si puede gestionar DNS, reglas de firewall y un host Linux. Incluye más que la plataforma de archivos básica; para la evaluación sin dominio, ownCloud indica que la configuración utiliza certificados autofirmados.

• Sistema operativo anfitrión: Ubuntu 24.04 LTS o 22.04 LTS con acceso SSH y sudo.
• Red: un dominio cuyos registros DNS requeridos se resuelven a la dirección WAN del servidor; permita los puertos TCP entrantes 22, 80 y 443 en el firewall y en cualquier enrutador ascendente.
• Software: Docker Engine y el complemento Compose. En Linux, Docker documenta la instalación a través de su repositorio de paquetes; después de la instalación, confirme que Compose responde con docker compose version.
• Correo electrónico: se requiere un valor SMTP_SENDERpara este ejemplo. Complete la configuración SMTP si desea recibir notificaciones por correo electrónico.

1. Instale Docker Compose y prepare el host.

Si Docker Engine ya está presente, instale el complemento Compose utilizando el método correspondiente a su distribución de Linux en las instrucciones oficiales de instalación de Compose de Docker . Para sistemas Ubuntu o Debian donde el repositorio de Docker está configurado, el comando de paquete documentado es:

sudo apt-get update
sudo apt-get install docker-compose-plugin
docker compose version

Docker recomienda el complemento y el docker composecomando para las instalaciones actuales. Si es necesario, instale Docker Engine siguiendo las instrucciones oficiales de Ubuntu .

Antes de descargar la configuración, apunte el dominio o los subdominios que planea usar a la IP pública del host. El ejemplo de ownCloud requiere OCIS_DOMAIN; también puede usar COLLABORA_DOMAINy ONLYOFFICE_DOMAINcuando se configuran esos servicios de oficina. Los nombres DNS deben coincidir con los valores en .env. Verifique que su enrutador reenvíe los puertos 80 y 443 a este host y que un firewall local los permita.

2. Obtén el ejemplo oficial de Compose

Utilice el ocis_fulldirectorio de la rama de los ejemplos de implementaciónstable-8.2 oficiales de ownCloud . Descargue el archivo ZIP en un ordenador con un navegador, transfiéralo al servidor sin interfaz gráfica con y extráigalo en como se describe en la guía de ownCloud.scp/opt/compose/ocis/ocis_full

Guarda el archivo actual .envantes de extraer una copia actualizada: ownCloud advierte que el archivo podría sobrescribirse. Ejecuta los comandos de Compose desde el directorio del proyecto.

3. Configurar dominios, certificados, correo electrónico y rutas de datos.

Ábrelo /opt/compose/ocis/ocis_full/.enven un editor de texto. Conserva los nombres de las variables y la sintaxis del ejemplo, y edita solo los valores que correspondan a tu instalación:

• Configure OCIS_DOMAINel nombre de host que ingresarán los usuarios. Configure los nombres de host de Collabora o OnlyOffice solo si esos servicios están habilitados en el ejemplo.
• Para un servidor con acceso a internet, comente la línea INSECUREsegún se indica en el ejemplo. No deje habilitada su configuración de seguridad para uso público.
• Configúrala TRAEFIK_ACME_MAILcon una dirección de correo electrónico que controles. Para la prueba inicial del certificado, configúrala TRAEFIK_ACME_CASERVERcon el servidor de prueba de Let's Encrypt. Los certificados de prueba no son de confianza para el uso normal; sirven para probar el DNS y la accesibilidad antes de solicitar certificados de producción.
• Configure esto SMTP_SENDER, incluso si aún no ha configurado un relé de correo que funcione. La guía oficial indica que la implementación no se iniciará sin ello. Agregue el host SMTP, el puerto, las credenciales, la autenticación y la configuración de seguridad cuando estén disponibles; sin la configuración de correo, la instancia puede iniciarse, pero no puede enviar notificaciones.
• Revise OCIS_DOCKER_IMAGElas etiquetas de imagen del ejemplo. No cambie de canal de lanzamiento sin precaución mientras esté siguiendo una instalación de versión estable.
• Para un servidor de producción, considere asignar OCIS_DATA_DIRrutas OCIS_CONFIG_DIRde host planificadas en un almacenamiento con capacidad suficiente y cobertura de respaldo. Por defecto, se utilizan volúmenes administrados por Docker, que son convenientes, pero ownCloud señala que su ubicación, instantáneas, copias de seguridad, restauración, reinicio y migración dependen del almacenamiento del host de Docker.

Restrinja el acceso al servidor y a su archivo de configuración. Un certificado autofirmado solo es adecuado para evaluación interna, no para una implementación pública de confianza.

Desde el directorio del proyecto, valide la configuración combinada antes de iniciar los contenedores:

cd /opt/compose/ocis/ocis_full
docker compose config

Corrija los errores de variables o YAML detectados antes de continuar. Este comando genera la configuración de Compose para su inspección; no garantiza que DNS, certificados, permisos de almacenamiento o conectividad SMTP funcionen correctamente.

4. Inicie los servicios y finalice la configuración del certificado.

Iniciar la pila en segundo plano:

docker compose up -d

La primera ejecución descarga las imágenes e inicia los servicios, por lo que puede tardar más que los reinicios posteriores. Compruebe el estado del servicio con:

docker compose ps -a

Luego, revise los registros si un servicio finaliza o si la dirección web no carga:

docker compose logs --follow

Comience revisando los registros de Traefik. Los errores de certificado suelen deberse a discrepancias en el DNS y .envlos valores, puertos 80/443 bloqueados o un correo electrónico ACME no válido. Solucione el problema antes de volver a intentarlo. No lo use docker compose down -vpara restablecerlo: elimina todos los volúmenes del proyecto, incluidos los datos.

Cuando las comprobaciones de certificados de prueba sean exitosas, siga el procedimiento de certificados de ownCloud: detenga la implementación, elimine solo el volumen de certificados del ejemplo ( ocis_full_certs), borre la configuración de CA de prueba y vuelva a iniciar para solicitar certificados de producción de confianza. Confirme el nombre exacto del volumen con docker volume lsantes de eliminarlo. No elimine los volúmenes de datos ni de configuración.

Verificar el acceso y proteger la implementación

Abra la URL configurada en OCIS_DOMAIN. Si el resultado es correcto, el navegador accede a la página de inicio de sesión mediante HTTPS sin advertencias de certificado y docker compose ps -amuestra que los servicios necesarios están en funcionamiento. Inicie sesión con las credenciales iniciales documentadas por ownCloud ( admin/ admin, a menos que haya configurado una contraseña inicial diferente) y, a continuación, cambie la contraseña de administrador inmediatamente.

Si el sitio no está disponible, revise el DNS, el reenvío de puertos, los registros ACME de Traefik y, a continuación, los registros del servicio Infinite Scale. Si el inicio de sesión funciona pero las notificaciones por correo electrónico no, revise la configuración SMTP.

Antes de almacenar archivos importantes, confirme que su copia de seguridad cubre tanto la configuración como los datos. Los volúmenes gestionados por Docker son prácticos para la evaluación; las rutas de host explícitas son más fáciles de ubicar en un disco aparte e incluir en las copias de seguridad del host. Estará listo cuando HTTPS sea válido, los servicios sigan funcionando después del reinicio, el inicio de sesión de administrador funcione y las copias de seguridad cubran el almacenamiento seleccionado.