LinuxParty

Montar una plataforma de edición colaborativa de documentos en Linux es hoy muchísimo más sencillo que hace unos años. Gracias a Docker, es posible desplegar una instancia completa de ONLYOFFICE Docs en apenas unos minutos y dejarla preparada para integrarse con plataformas como Nextcloud, ownCloud o incluso desarrollos propios.

En esta guía veremos cómo instalar ONLYOFFICE Docs utilizando Docker, de forma práctica y orientada a administradores Linux.

¿Qué vamos a instalar?

ONLYOFFICE Docs es el componente encargado de editar documentos online:

• documentos de texto
• hojas de cálculo
• presentaciones
• colaboración en tiempo real
• comentarios y control de cambios

La instalación mediante Docker evita tener que instalar manualmente decenas de dependencias.

Requisitos previos

Antes de comenzar necesitaremos:

• Un servidor Linux actualizado
• Docker instalado
• Docker Compose (recomendado)
• Al menos 4 GB de RAM
• Acceso root o sudo
• Un dominio o subdominio si se va a publicar online

Instalar Docker en Linux

En distribuciones basadas en Debian o Ubuntu:

sudo apt update
sudo apt install docker.io docker-compose -y

Activamos y arrancamos Docker:

sudo systemctl enable docker
sudo systemctl start docker

Comprobamos que funciona:

docker --version

Crear directorios persistentes

Uno de los errores más habituales es no guardar los datos fuera del contenedor. Si el contenedor se elimina, también desaparecería toda la configuración.

Creamos una estructura básica:

mkdir -p /opt/onlyoffice/{logs,data,lib,db}

Esto permitirá mantener:

• logs
• configuración
• datos internos
• base de datos

aunque el contenedor sea actualizado o recreado.

Generar una clave JWT

ONLYOFFICE utiliza JWT para autenticar integraciones y conexiones internas.

Generamos una clave segura:

export JWT_SECRET=$(tr -dc A-Za-z0-9 </dev/urandom | head -c 32)

Podemos comprobarla:

echo $JWT_SECRET

Instalación rápida con Docker

Ahora sí, lanzamos el contenedor:

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

¿Qué hace cada parámetro?

Nombre del contenedor

--name onlyoffice

Define el nombre interno del contenedor.

Reinicio automático

--restart=always

Hace que ONLYOFFICE vuelva a arrancar automáticamente tras reinicios del servidor.

Publicación de puertos

-p 80:80

Expone el puerto web del contenedor.

Variables JWT

-e JWT_ENABLED=true
-e JWT_SECRET=$JWT_SECRET

Activa la autenticación segura entre servicios.

Volúmenes persistentes

-v /opt/onlyoffice/logs:/var/log/onlyoffice

Guardan datos fuera del contenedor.

Verificar que el contenedor está funcionando

Comprobamos el estado:

sudo docker ps

Deberíamos ver algo parecido a:

CONTAINER ID   IMAGE                         STATUS
xxxxxxxxxxxx   onlyoffice/documentserver    Up

Acceder desde el navegador

Abrimos:

http://IP-DEL-SERVIDOR

O el dominio configurado:

http://docs.midominio.com

Si todo ha ido bien aparecerá la página de bienvenida de ONLYOFFICE Docs.

Instalación usando Docker Compose

Aunque docker run funciona perfectamente, Docker Compose facilita mucho el mantenimiento.

Creamos un directorio:

mkdir /opt/onlyoffice-compose
cd /opt/onlyoffice-compose

Creamos el archivo docker-compose.yml:

version: '3'

services:
  onlyoffice:
    image: onlyoffice/documentserver
    container_name: onlyoffice
    restart: always

    ports:
      - "80:80"

    environment:
      JWT_ENABLED: "true"
      JWT_SECRET: "CAMBIA_ESTA_CLAVE"

    volumes:
      - /opt/onlyoffice/logs:/var/log/onlyoffice
      - /opt/onlyoffice/data:/var/www/onlyoffice/Data
      - /opt/onlyoffice/lib:/var/lib/onlyoffice
      - /opt/onlyoffice/db:/var/lib/postgresql

Guardamos y arrancamos:

sudo docker compose up -d

Ver logs del servidor

Muy útil para depuración:

sudo docker logs -f onlyoffice

Cómo actualizar ONLYOFFICE

Una de las ventajas de Docker es la facilidad para actualizar.

Descargamos la nueva imagen:

sudo docker pull onlyoffice/documentserver

Detenemos el contenedor:

sudo docker stop onlyoffice
sudo docker rm onlyoffice

Y lo recreamos usando el mismo comando o docker compose up -d.

Gracias a los volúmenes persistentes no perderemos la configuración.

Recomendación importante: usar HTTPS

Si ONLYOFFICE va a estar accesible desde Internet, es muy recomendable usar:

• Nginx
• Apache
• Traefik
• certificados Let's Encrypt

Esto es especialmente importante si se integra con Nextcloud u otras plataformas.

Integración con Nextcloud

ONLYOFFICE dispone de integración oficial con Nextcloud.

Basta con:

1. Instalar la aplicación ONLYOFFICE desde Nextcloud.
2. Indicar la URL del servidor ONLYOFFICE.
3. Configurar la misma clave JWT en ambos lados.

Con eso tendremos edición colaborativa directamente desde Nextcloud.

ONLYOFFICE Docs se ha convertido en una de las soluciones más interesantes para quienes desean disponer de edición colaborativa autoalojada sobre Linux.

Gracias a Docker:

• la instalación es rápida
• las actualizaciones son sencillas
• el mantenimiento se simplifica
• la migración entre servidores es muy cómoda

Y lo mejor: manteniendo el control completo sobre los datos y la infraestructura.