Instala ONLYOFFICE con Docker y convierte tu servidor en una nube ofimática privada, segura y profesional

ONLYOFFICE Docs es una suite ofimática en línea que permite crear, visualizar y editar documentos de texto, hojas de cálculo y presentaciones desde el navegador. Su principal atractivo es que puede desplegarse en un servidor propio, lo que permite a empresas, instituciones educativas, equipos técnicos y usuarios avanzados mantener mayor control sobre sus documentos, su infraestructura y sus integraciones.

Instalar ONLYOFFICE mediante Docker simplifica el proceso porque encapsula los servicios necesarios dentro de un contenedor. En lugar de instalar manualmente dependencias, base de datos, servicios internos y componentes de edición, se ejecuta una imagen oficial preparada para levantar el servicio de forma más rápida, reproducible y controlada.

¿Qué es ONLYOFFICE Docs y por qué instalarlo en tu servidor?

ONLYOFFICE Docs, también conocido como Document Server, es el componente que proporciona los editores web para documentos, hojas de cálculo, presentaciones, formularios y archivos PDF. Su función no es reemplazar por completo a una nube de archivos, sino integrarse con plataformas de almacenamiento y colaboración como Nextcloud, ownCloud, Seafile, Moodle, Odoo u otras soluciones compatibles.

Al instalarlo en un servidor propio, la organización puede controlar el entorno de edición, definir políticas de acceso, integrar la suite con su nube privada y evitar que los documentos dependan exclusivamente de servicios externos. Esto resulta especialmente útil para instituciones que manejan documentos internos, contratos, informes, hojas de cálculo colaborativas o material académico.

Requisitos recomendados para instalar ONLYOFFICE con Docker

Antes de iniciar la instalación, es importante validar que el servidor cumpla con los requisitos mínimos. Aunque Docker simplifica el despliegue, ONLYOFFICE Docs sigue siendo una aplicación de servidor que requiere recursos suficientes para procesar documentos, gestionar sesiones, convertir archivos y atender usuarios concurrentes.

Paso 1: Preparar el servidor Linux

El primer paso consiste en actualizar el sistema operativo y preparar el servidor. Es recomendable iniciar desde una instalación limpia, con acceso SSH seguro, usuario administrador, firewall activo y una dirección IP pública o privada según el entorno donde se usará ONLYOFFICE.

sudo apt update
sudo apt upgrade -y

En distribuciones basadas en Red Hat, como AlmaLinux o Rocky Linux, el proceso de actualización se realiza con dnf. Lo importante es iniciar la instalación con paquetes actualizados y sin servicios innecesarios escuchando en los puertos que usará ONLYOFFICE.

sudo dnf update -y

Paso 2: Instalar Docker Engine

ONLYOFFICE Docs puede ejecutarse usando una imagen Docker oficial. Para ello, el servidor debe tener Docker Engine instalado y funcionando. En servidores Linux se recomienda seguir la documentación oficial de Docker según la distribución utilizada, ya sea Ubuntu, Debian, Fedora, CentOS, RHEL, AlmaLinux o Rocky Linux.

Una vez instalado Docker, conviene verificar que el servicio esté activo y que el usuario administrador pueda ejecutar contenedores.

sudo systemctl enable docker
sudo systemctl start docker
docker --version

Paso 3: Crear directorios persistentes para ONLYOFFICE

Aunque Docker permite ejecutar la aplicación rápidamente, en un servidor real no conviene dejar los datos únicamente dentro del contenedor. Si el contenedor se elimina o se recrea, podría perderse información operativa importante. Por eso se recomienda montar volúmenes persistentes en el host.

Estos volúmenes permiten conservar logs, certificados, caché, base de datos y archivos internos necesarios para el funcionamiento de ONLYOFFICE Docs.

sudo mkdir -p /app/onlyoffice/DocumentServer/logs
sudo mkdir -p /app/onlyoffice/DocumentServer/data
sudo mkdir -p /app/onlyoffice/DocumentServer/lib
sudo mkdir -p /app/onlyoffice/DocumentServer/db

Paso 4: Ejecutar ONLYOFFICE Docs con Docker

La forma más directa de instalar ONLYOFFICE Docs es ejecutar el contenedor oficial onlyoffice/documentserver. Para una instalación básica de prueba, se puede publicar el puerto 80 del contenedor hacia el puerto 80 del servidor.

sudo docker run -i -t -d \
  --name onlyoffice-documentserver \
  -p 80:80 \
  --restart=always \
  -e JWT_SECRET=CAMBIA_ESTA_CLAVE_SEGURA \
  onlyoffice/documentserver

Para una instalación más adecuada en producción, se recomienda incluir volúmenes persistentes desde el inicio. Esto permite actualizar o recrear el contenedor sin perder datos operativos.

sudo docker run -i -t -d \
  --name onlyoffice-documentserver \
  -p 80:80 \
  --restart=always \
  -e JWT_ENABLED=true \
  -e JWT_SECRET=CAMBIA_ESTA_CLAVE_SEGURA \
  -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice \
  -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data \
  -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \
  -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql \
  onlyoffice/documentserver

Paso 5: Verificar que ONLYOFFICE esté funcionando

Después de ejecutar el contenedor, se puede verificar su estado con Docker. El contenedor debe aparecer en ejecución y sin reinicios constantes. Si el servicio no responde, conviene revisar los logs.

sudo docker ps
sudo docker logs onlyoffice-documentserver --tail=100

Luego abre en el navegador la dirección IP o dominio del servidor. Si el despliegue fue correcto, ONLYOFFICE mostrará una página de bienvenida o comprobación del Document Server.

Paso 6: Activar HTTPS con proxy inverso

Para un entorno productivo, ONLYOFFICE debe publicarse mediante HTTPS. Esto es especialmente importante si se integrará con Nextcloud, ownCloud u otra plataforma accesible desde Internet. Una práctica habitual es colocar un proxy inverso como Nginx, Apache o Traefik delante del contenedor.

El proxy inverso se encarga de recibir conexiones HTTPS, gestionar certificados TLS, redirigir tráfico y entregar las solicitudes al contenedor de ONLYOFFICE. Esto permite mantener una arquitectura más ordenada y segura.

Paso 7: Integrar ONLYOFFICE con Nextcloud u ownCloud

ONLYOFFICE Docs no gestiona por sí solo usuarios, carpetas y almacenamiento colaborativo como lo hace una nube de archivos. Por eso, normalmente se integra con plataformas como Nextcloud u ownCloud. En ese escenario, ONLYOFFICE actúa como motor de edición de documentos, mientras la nube gestiona usuarios, permisos, archivos y compartición.

El proceso general consiste en instalar el conector correspondiente en Nextcloud u ownCloud, indicar la URL pública de ONLYOFFICE Docs y configurar la misma clave JWT utilizada en el contenedor.

Instalación alternativa con Docker Compose

Para servidores administrados de forma ordenada, Docker Compose puede ser una mejor opción que ejecutar comandos largos con docker run. Permite definir el servicio, puertos, variables de entorno, volúmenes y política de reinicio en un archivo YAML.

version: "3.8"

services:
  onlyoffice-documentserver:
    image: onlyoffice/documentserver:latest
    container_name: onlyoffice-documentserver
    restart: always
    ports:
      - "80:80"
    environment:
      JWT_ENABLED: "true"
      JWT_SECRET: "CAMBIA_ESTA_CLAVE_SEGURA"
    volumes:
      - /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice
      - /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data
      - /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice
      - /app/onlyoffice/DocumentServer/db:/var/lib/postgresql

Para iniciar el servicio con Docker Compose, guarda el archivo como docker-compose.yml y ejecuta:

sudo docker compose up -d
sudo docker compose ps
sudo docker compose logs -f

Comparativa rápida: docker run vs Docker Compose

Cómo actualizar ONLYOFFICE desplegado con Docker

Una de las ventajas de Docker es que facilita la actualización de la aplicación. Si se han configurado volúmenes persistentes correctamente, el contenedor puede recrearse con una imagen más reciente sin perder datos almacenados fuera del contenedor.

sudo docker pull onlyoffice/documentserver:latest
sudo docker stop onlyoffice-documentserver
sudo docker rm onlyoffice-documentserver

Luego se vuelve a ejecutar el contenedor con los mismos volúmenes y variables de entorno. En entornos productivos, conviene realizar respaldo antes de actualizar y probar primero en un servidor de pruebas.

Seguridad básica para publicar ONLYOFFICE en Internet

Si ONLYOFFICE estará disponible desde Internet, la seguridad debe ser parte del diseño desde el inicio. No basta con ejecutar el contenedor. Se debe proteger el acceso, usar HTTPS, configurar JWT, limitar puertos expuestos, mantener el servidor actualizado y monitorear logs.

Errores frecuentes al instalar ONLYOFFICE con Docker

Los problemas más comunes suelen estar relacionados con puertos ocupados, falta de memoria, permisos en volúmenes, configuración incorrecta de JWT, certificados TLS no válidos o errores de comunicación con la plataforma que se integra.

¿Para quién es recomendable instalar ONLYOFFICE en servidor propio?

Esta instalación es recomendable para organizaciones que ya cuentan con una nube privada o desean construir una solución colaborativa bajo su propio control. También es útil para centros educativos, consultoras, pequeñas empresas, equipos de desarrollo, estudios profesionales y usuarios técnicos que desean editar documentos en línea sin depender por completo de plataformas externas.

Conclusión

Instalar ONLYOFFICE Docs con Docker en un servidor propio es una solución práctica para construir una plataforma ofimática privada, colaborativa y compatible con documentos de uso común. Docker simplifica el despliegue, facilita actualizaciones y permite mantener un entorno más ordenado mediante volúmenes persistentes y variables de configuración.

Para un entorno real, la clave está en no limitarse al comando básico de instalación. Es necesario configurar volúmenes, activar JWT, publicar el servicio mediante HTTPS, integrarlo correctamente con Nextcloud u ownCloud, respaldar datos y aplicar buenas prácticas de seguridad. Con una implementación adecuada, ONLYOFFICE puede convertirse en una pieza central de una nube privada libre y profesional.