Cómo configurar ONLYOFFICE Workspace en Ubuntu 24.04 LTS

ONLYOFFICE Workspace combina la edición de documentos en línea con un portal de colaboración más amplio. En Ubuntu 24.04 LTS, la configuración de servidor más sencilla consiste en usar el script de instalación oficial de la comunidad de ONLYOFFICE Workspace con Docker. Docker ejecuta los componentes de Workspace en contenedores aislados, lo que facilita la reproducción y actualización del despliegue en comparación con una configuración manual.

Esta guía utiliza la edición Community y comienza con una opción práctica para administradores principiantes: instalar Workspace sin el servidor de correo ONLYOFFICE opcional. Esto elimina los requisitos de DNS y entrega de correo en la primera implementación. Si lo necesita, puede agregar el servidor de correo más adelante desde el Panel de control.

Desde octubre de 2026, Docker es compatible oficialmente con Ubuntu 24.04 LTS (Noble). La documentación actual de la comunidad Workspace de ONLYOFFICE recomienda un host Linux amd64 con al menos una CPU de 4 núcleos, 8 GB de RAM, 40 GB de espacio libre en disco y 6 GB de memoria de intercambio. El proveedor recomienda mayor CPU y RAM para una implementación más fluida. Consulte la guía de instalación de Docker de la comunidad Workspace de ONLYOFFICE y la documentación de instalación de Docker para Ubuntu antes de implementar en un servidor de producción.

Lo que necesitas antes de empezar

Necesitas un servidor o máquina virtual Ubuntu 24.04 LTS, una cuenta con sudoprivilegios, acceso a internet para descargar paquetes e imágenes de contenedores y suficientes recursos libres para los servicios de Workspace. Si quieres que el portal sea accesible desde otros ordenadores, el servidor también necesita una dirección LAN estable o una dirección IP pública.

amd64 se refiere a la arquitectura de servidor x86 de 64 bits común utilizada por los procesadores Intel y AMD. No asuma que la compatibilidad de Docker con otra arquitectura implica automáticamente que ONLYOFFICE Workspace también la admita; los requisitos actuales de Workspace mencionan específicamente Linux amd64.

Paso 1: Confirme que el host Ubuntu tiene suficientes recursos.

Abre la terminal o conéctate al servidor mediante SSH. Ejecuta:

uname -m
free -h
df -h

uname -minforma la arquitectura del procesador. En un host x86-64 compatible, normalmente verá x86_64. free -hmuestra la RAM y el espacio de intercambio, mientras que df -hmuestra el espacio libre en disco en unidades legibles para humanos.

Evite continuar en un servidor que ya tenga poca memoria o almacenamiento. La instalación podría completarse, pero fallar posteriormente durante las tareas de edición o indexación, lo cual es más difícil de diagnosticar que corregir primero la capacidad.

Paso 2: Instala Docker Engine desde el repositorio oficial de Docker para Ubuntu.

Docker Engine es el servicio que crea y ejecuta los contenedores utilizados en la implementación de Workspace. Las instrucciones actuales de Docker para Ubuntu son compatibles con Ubuntu 24.04 LTS y recomiendan usar el repositorio APT de Docker para una instalación normal en un servidor.

Primero, instale las herramientas básicas del repositorio:

sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings

Agregue la clave de firma y el repositorio actuales de Docker:

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg   -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

A continuación, instale Docker Engine y el complemento Compose:

sudo apt install -y docker-ce docker-ce-cli containerd.io   docker-buildx-plugin docker-compose-plugin

Confirme que el servicio está en funcionamiento:

sudo systemctl status docker --no-pager

Paso 3: Verifique Docker antes de involucrar a ONLYOFFICE.

Esta pequeña comprobación separa los problemas de Docker de los problemas de Workspace. Ejecutar:

sudo docker run --rm hello-world

Docker descarga una pequeña imagen de prueba, inicia un contenedor, imprime un mensaje de confirmación y finaliza. Si esto falla, corrige primero el problema de Docker en lugar de continuar con el script de Workspace.

Un error común entre principiantes es confundir un error de permisos con dockerun fallo de ONLYOFFICE. Esta guía utiliza intencionadamente sudo docker, por lo que no es necesario añadir tu cuenta al grupo Docker. Docker advierte que pertenecer a ese grupo otorga efectivamente control de nivel root, así que no añadas usuarios a la ligera solo para abreviar comandos.

Paso 4: Descargue el instalador oficial de ONLYOFFICE Workspace.

ONLYOFFICE publica un script de instalación en su propio dominio de descarga. Descárguelo directamente:

curl -O https://download.onlyoffice.com/install/workspace-install.sh

Antes de ejecutar cualquier script administrativo descargado, es recomendable inspeccionarlo:

less workspace-install.sh

Pulsa qpara salir less. Esto no garantiza la seguridad del script, pero te permite verificar su origen y detectar comandos inesperados antes de otorgarle privilegios de administrador.

Paso 5: Instale Workspace sin el servidor de correo primero.

Para una primera implementación, ejecute el script oficial omitiendo ONLYOFFICE Mail:

sudo bash workspace-install.sh -ims false

El -ims falseparámetro significa «no instalar el componente del servidor de correo». Esto permite que la configuración inicial se centre en el portal del espacio de trabajo, los editores de documentos y los componentes de administración. ONLYOFFICE indica que el servidor de correo se puede instalar posteriormente desde el Panel de control.

Si ya dispone de un dominio de servicio de correo electrónico configurado correctamente y desea específicamente la instalación completa, ONLYOFFICE documenta este formulario en su lugar:

sudo bash workspace-install.sh -md "mx1.example.com"

Sustituya esto mx1.example.compor el nombre de host real de su servicio de correo. El nombre de host debe resolverse al servidor y el dominio de correo necesita los registros DNS adecuados. No utilice un nombre de host ficticio solo para que el instalador continúe. Un DNS incorrecto es una de las maneras más fáciles de convertir una implementación exitosa de Workspace en un problema de entrega de correo.

Paso 6: Compruebe que los contenedores se estén ejecutando correctamente.

Cuando finalice el script, inspeccione los contenedores en ejecución:

sudo docker ps

No se preocupe si los nombres de sus contenedores difieren de los ejemplos que ve en línea. Los nombres y los componentes internos pueden cambiar entre versiones. Lo importante es que los contenedores ONLYOFFICE esperados estén presentes y su estado sea "en ejecución" en lugar de reiniciarse o cerrarse repetidamente.

Si un contenedor se reinicia continuamente, inspeccione el nombre real docker ps -ay luego ejecute:

sudo docker logs --tail 100 CONTAINER_NAME

Reemplácelo CONTAINER_NAMEcon un nombre que muestre Docker. Esto es más seguro que copiar el nombre de un contenedor antiguo de un tutorial.

Paso 7: Abra el portal utilizando la dirección de red real del servidor.

Encuentra las direcciones de los servidores con:

hostname -I

Desde un navegador que pueda acceder al servidor, abra:

http://SERVER_IP

La guía de Docker de ONLYOFFICE recomienda específicamente usar la dirección IP de red de la máquina en lugar de localhostverificar 127.0.0.1el portal. El inicio inicial puede tardar unos minutos después de la instalación, por lo que una breve demora no significa automáticamente que la implementación haya fallado.

Paso 8: Completar la configuración del administrador.

La página de inicio le pide que cree una cuenta de administrador del portal. Establezca una contraseña segura, ingrese una dirección de correo electrónico válida, seleccione el idioma y la zona horaria correctos y acepte los términos de la licencia. ONLYOFFICE indica que la política de contraseñas predeterminada requiere entre 8 y 120 caracteres; puede ajustar la configuración de seguridad posteriormente.

Tras el asistente inicial, confirme que puede abrir el módulo Documentos y crear un documento de prueba. El simple hecho de iniciar sesión correctamente demuestra que el portal está accesible; abrir y editar un documento también verifica que el componente de edición de documentos esté conectado correctamente.

Asegure la instalación antes de invitar a los usuarios.

Si el servidor se va a utilizar más allá de un entorno de laboratorio temporal, cambie de HTTP simple a HTTPS. El panel de control de ONLYOFFICE puede generar y aplicar un certificado Let's Encrypt o aceptar un certificado y una clave privada existentes. Para el flujo de trabajo integrado de Let's Encrypt, el puerto 80 debe estar accesible durante la emisión del certificado. Consulte la guía oficial de configuración HTTPS de ONLYOFFICE .

Compruebe también qué puertos de red necesita realmente. ONLYOFFICE publica una referencia de puertos de la comunidad Workspace . No exponga los puertos de la base de datos o de los servicios internos a Internet solo porque aparezcan en esa tabla.

Ubuntu incluye UFW, un cortafuegos para el host, pero existe una advertencia importante específica de Docker: la documentación de Docker advierte que los puertos de contenedores publicados pueden eludir las reglas de UFW. Esto significa que «lo bloqueé en UFW» no es prueba suficiente de que un puerto publicado por Docker sea inaccesible. Revise el comportamiento del cortafuegos de Docker y, para un servidor con acceso a Internet, utilice una política de cortafuegos de host o de origen bien diseñada en lugar de asumir que UFW por sí solo controla todos los puertos de los contenedores. La referencia del cortafuegos de Ubuntu está disponible en la documentación del cortafuegos de Ubuntu Server .

Problemas comunes y qué revisar primero

El instalador indica que un puerto necesario ya está en uso.

Compruebe los oyentes antes de detener servicios aleatorios:

sudo ss -ltnp | grep -E ':(80|443)\b'

Si Apache, Nginx, otro contenedor o un panel de administración ya utiliza el puerto, decida qué servicio debe conservarlo. No detenga indiscriminadamente un servidor web de producción.

El portal no carga después de la instalación.

Primero, revisa Docker:

sudo systemctl is-active docker
sudo docker ps -a

Si Docker está inactivo, inícielo y revise su registro. Si los contenedores de Workspace están activos pero la página no está disponible, confirme que está utilizando la IP del servidor correcta y que el enrutamiento, los grupos de seguridad de la nube y los firewalls ascendentes permiten el tráfico web necesario.

El servidor se queda sin memoria durante la instalación.

Vuelva a comprobarlo free -h. La guía basada en scripts de Workspace requiere al menos 6 GB de espacio de intercambio y especifica 8 GB de RAM como mínimo. Una máquina virtual muy pequeña puede volverse inestable mientras se inicializan varias imágenes simultáneamente. Migrar a una máquina virtual más grande suele ser una solución más limpia que intentar optimizar cada servicio en función de la falta de memoria.

Necesitas ONLYOFFICE Mail más adelante

No es necesario reinstalar Workspace. ONLYOFFICE documenta cómo agregar el servidor de correo desde la página de Actualización del Panel de control. Antes de hacerlo, prepare un nombre de host de servicio real y sus registros DNS. Consulte la guía de ONLYOFFICE para agregar correo a una instalación existente de Workspace .

Prefieres Docker Compose en lugar del script de instalación.

Esta es una alternativa válida si desea tener mayor control sobre la definición de la implementación. Las instrucciones actuales de Compose de ONLYOFFICE requieren Docker Compose 2.16.0 o posterior para Ubuntu 22.04 y versiones posteriores, e indican a los administradores que habiliten la cgrouplínea correspondiente en el archivo YAML del espacio de trabajo. Ubuntu 24.04 se incluye en la categoría de "22.04 y versiones posteriores". Siga la guía oficial de Docker Compose de ONLYOFFICE en lugar de copiar un archivo Compose antiguo de un tutorial no relacionado.

Cómo saber si la configuración está realmente terminada

Una instalación correcta presenta varias señales independientes de buen funcionamiento: Docker está activo; los contenedores de Workspace siguen en ejecución; el portal se abre desde otra máquina utilizando la dirección de red real del servidor; el administrador puede iniciar sesión; y se abre un documento de prueba en el editor del navegador. Si planea exponer el servicio públicamente, HTTPS también debe funcionar con un certificado en el que confíen los navegadores.

Para una primera implementación de Ubuntu 24.04, es mejor detenerse después de realizar esas comprobaciones que agregar inmediatamente correo electrónico, proxies inversos personalizados, almacenamiento de terceros e integraciones de autenticación. Agregue una función a la vez, verifíquela y mantenga un registro de los cambios de DNS, firewall y contenedores. Esto facilita enormemente la resolución de problemas posteriores.