Instalar ONLYOFFICE con Docker en Linux

¿Qué es ONLYOFFICE?

ONLYOFFICE es una suite ofimática empresarial que integra CRM, gestión de proyectos y documentos, colaboración en tiempo real, calendario y correo. Se compone de tres servidores principales:

• Community Server: módulos como Personas, Proyectos, CRM, Documentos, Comunidad, cliente de correo, calendario y chat.
• Document Server: editores en línea para texto, hojas de cálculo y presentaciones con co-edición en tiempo real y control de versiones.
• Mail Server: gestión de correo entrante y saliente para la suite.

Novedades destacadas en las versiones citadas:

• Community Server 8.9.0: integración de correo y calendario, respuestas automáticas, libreta de direcciones y revisión de permisos de acceso.
• Document Server 4.0: co-edición en tiempo real más rápida, chat y comentarios integrados, revisión y seguimiento de cambios y historial de versiones.

Requisitos del sistema y dependencias

Asegúrate de que la máquina cumple los siguientes requisitos mínimos:

• RAM: 6 GB o más.
• Disco (HDD/SSD): al menos 2 GB libres para la instalación básica (se recomienda más para datos reales).
• Swap: al menos 2 GB.
• Nombre de dominio registrado para el servidor de correo (ej. midominio.com).
• Docker: versión 1.10 o superior.

Nota: las instrucciones de instalación de Docker están en la documentación oficial de Docker.

Importante: para entornos productivos aumenta RAM y espacio en disco según número de usuarios y volumen de documentos.

Preparación breve

1. Abre una terminal (por ejemplo con Ctrl+Alt+T).
2. Verifica que Docker está instalado y funcionando: docker version.
3. Comprueba que no existen contenedores con los mismos nombres para evitar conflictos.

Crear la red Docker para ONLYOFFICE

Crea una red aislada para los contenedores de ONLYOFFICE:

docker network create --driver bridge onlyoffice

Esta red permite que los contenedores se descubran entre sí por nombre.

Instalar Document Server

Ejecuta el contenedor del Document Server en la red onlyoffice:

sudo docker run --net onlyoffice -i -t -d --restart=always --name onlyoffice-document-server onlyoffice/documentserver

Document Server es responsable de los editores en línea y debe estar accesible desde Community Server.

Instalar Mail Server

Sustituye yourdomain.com por tu dominio registrado antes de ejecutar este comando:

sudo docker run --net onlyoffice --privileged -i -t -d --restart=always --name onlyoffice-mail-server \
-p 25:25 -p 143:143 -p 587:587 \
-h yourdomain.com \
onlyoffice/mailserver

El Mail Server expone los puertos SMTP/IMAP/Submission. Para producción debes considerar TLS y reglas de firewall.

Instalar Community Server

Lanza el Community Server enlazando las variables de entorno para que apunte a los otros contenedores:

sudo docker run --net onlyoffice -i -t -d -p 80:80 --restart=always --name onlyoffice-community-server \
-p 80:80 -p 5222:5222 -p 443:443 \
-e DOCUMENT_SERVER_PORT_80_TCP_ADDR=onlyoffice-document-server \
-e MAIL_SERVER_DB_HOST=onlyoffice-mail-server \
onlyoffice/communityserver

Community Server proporciona la interfaz web y orquesta las llamadas al Document y Mail Server.

Acceder al web-office

Abre un navegador y escribe la IP o el nombre de host del servidor. Crea una cuenta administrativa con tu correo y contraseña, configura la zona horaria y el idioma y guarda.

La página de bienvenida aparecerá así:

Selecciona la herramienta que necesites y comienza a trabajar.

Comprobaciones rápidas después de la instalación

• Verifica que los tres contenedores están en ejecución:

docker ps --filter "name=onlyoffice"

• Revisa logs si algo falla:

docker logs onlyoffice-community-server

• Comprueba conectividad entre contenedores:

docker exec -it onlyoffice-community-server ping -c 3 onlyoffice-document-server

Alternativas y enfoques diferentes

• Docker Compose: para una gestión más sencilla de múltiples contenedores crea un archivo docker-compose.yml y define servicios y volúmenes.
• Kubernetes: para entornos escalables y tolerantes a fallos, despliega ONLYOFFICE usando manifests y servicios en un cluster.
• Instalación nativa: instalar paquetes directamente en la máquina evita la capa Docker pero requiere más gestión de dependencias.

Mini-metodología de despliegue (pasos recomendados)

1. Planificación: estimar recursos según usuarios concurrentes.
2. Pruebas en entorno aislado: despliegue inicial en VM o servidor de pruebas.
3. Backup y recuperación: definir estrategia de copias para base de datos y volúmenes.
4. Monitorización: configurar métricas y alertas (CPU, memoria, uso de disco, disponibilidad HTTP).
5. Migración a producción: validar TLS, DNS y certificados, luego promover el despliegue.

Checklist por roles

• Administrador de sistemas:

  • Comprobar requisitos y DNS.
  • Aplicar TLS (Let’s Encrypt / certificados válidos).
  • Configurar firewalls y reglas de NAT/puertos.

• Desarrollador/integración:

  • Probar API y webhooks.
  • Verificar integraciones con CRM y proyectos.

• Soporte/Helpdesk:

  • Validar acceso de usuarios y permisos.
  • Registrar procedimientos de recuperación de contraseña.

Seguridad y buenas prácticas

• No expongas puertos innecesarios al público. Usa firewall y proxys reversos (nginx) para TLS.
• Activa HTTPS en producción y renueva certificados automáticamente.
• Respalda volúmenes que contienen datos importantes y bases de datos.
• Mantén Docker y las imágenes actualizadas y revisa notas de seguridad.

Solución de problemas comunes

• Error: puerto en uso — asegúrate de que ningún servicio (como Apache o nginx) esté ocupando el puerto 80/443.
• Conexión entre contenedores fallida — confirma que la red onlyoffice existe y que los contenedores usan --net onlyoffice.
• Correo no se envía — revisa DNS (SPF, DKIM) y logs del Mail Server.

Decisión rápida (flujo)

flowchart TD
  A[¿Necesitas alta disponibilidad?] -->|Sí| B[Kubernetes u orquestador]
  A -->|No| C[Docker en una sola máquina]
  B --> D[Configurar cluster, volúmenes persistentes, Ingress TLS]
  C --> E[Seguir este tutorial y añadir proxy TLS]

Migración y compatibilidad

• Migrar desde una instalación existente: exporta datos de Community Server y restaura volúmenes en el nuevo contenedor.
• Versiones: confirma compatibilidad entre Community Server y Document Server en las notas de la versión.

Enlaces útiles

• Documentación oficial de ONLYOFFICE: consulta la guía de instalación y configuración.
• Descargas con máquinas virtuales preinstaladas: página de descargas oficiales.
• Código fuente y binarios: onlyoffice.org.
• Soporte y comunidad de desarrolladores: dev.onlyoffice.org.

Resumen

ONLYOFFICE con Docker facilita desplegar una suite ofimática completa en una sola máquina Linux. Sigue los requisitos mínimos, crea la red Docker y ejecuta los tres contenedores. Para producción considera TLS, backups y monitorización.

Notas finales:

• Este tutorial describe una instalación básica. Para entornos de producción analiza dimensionamiento, disponibilidad y seguridad.
• Si prefieres administrar múltiples contenedores de forma declarativa, usa Docker Compose o Kubernetes.