Cómo actualizar OnlyOffice paso a paso en todos sus componentes

Si trabajas a diario con ONLYOFFICE, tarde o temprano te tocará actualizar la plataforma para disfrutar de las últimas funciones, mantener la seguridad al día y corregir errores. El problema es que no todas las instalaciones se actualizan igual: no es lo mismo un DocSpace autoalojado que ONLYOFFICE Docs en Linux, Workspace en Windows o el servidor de correo basado en Docker.

A continuación tienes una guía muy completa donde se recopila, reordena y explica de forma clara toda la información dispersa sobre cómo actualizar ONLYOFFICE en sus distintos componentes y escenarios habituales: DocSpace, Docs Community Edition, Mail Server, Workspace y más. El objetivo es que, tengas la configuración que tengas, sepas qué comando ejecutar, qué carpetas respaldar y qué cambios trae cada versión sin volverte loco buscando en docenas de manuales.

Qué incluye una actualización de ONLYOFFICE y por qué merece la pena

Antes de meternos en comandos y scripts conviene entender qué implica realmente actualizar ONLYOFFICE y qué mejoras concretas suelen llegar con cada versión, ya que así resulta más fácil justificar la parada de servicio o la tarea de mantenimiento.

En el panel de actualización de ONLYOFFICE suele aparecer un bloque de cambios donde se listan las novedades por módulo: desde el panel de actualización (Update), pasando por el buscador interno, hasta módulos como LoginHistory, AuditTrail, Restore o SSO. Esos listados son mucho más que simple relleno, porque afectan directamente a la administración diaria.

• Update: se ha añadido, por ejemplo, un cuadro de diálogo con el acuerdo de licencia cuando instalas componentes Docker, y se ha corregido un problema con los botones inactivos para componentes no instalados que ahora permiten descargar e instalar la versión disponible.
• Search: se incorpora la visualización del progreso de indexado, lo que ayuda a saber en qué punto está el buscador cuando gestiona grandes cantidades de documentos.
• LoginHistory y AuditTrail: se han añadido nuevas pantallas vacías pensadas para mostrar la información de manera más clara, aunque al principio aún no haya datos.
• Restore: se incluyen controles adicionales al restaurar datos desde almacenamiento local o servicios de terceros, reduciendo el riesgo de restauraciones corruptas o incompletas.
• SSO: la funcionalidad SSOAuth deja de estar en el Panel de Control y pasa a formar parte de las opciones de portal dentro de Community Server, algo clave si gestionas inicio de sesión único.
• Corrección de errores y licencias: se resuelven múltiples incidencias internas (bugs 47721, 49101, 49187, 49273, 49272, 49324, 46386, 49585) y se actualizan las licencias y copyrights de terceros, algo esencial de cara a cumplimiento.

Todo esto viene a demostrar que las actualizaciones van mucho más allá de un simple cambio estético: incluyen mejoras de seguridad, estabilidad, interfaz y compatibilidad que, en entornos productivos, marcan una gran diferencia.

Novedades al actualizar ONLYOFFICE DocSpace a la versión 2.5

DocSpace es la plataforma de ONLYOFFICE centrada en salas de trabajo y colaboración sobre documentos. Con la actualización a la versión 2.5, tanto en la nube como autoalojada, se añaden un buen puñado de funciones que cambian bastante la forma de compartir y organizar archivos.

Entre las capacidades que obtienes al actualizar DocSpace a 2.5 destacan las relacionadas con el intercambio de documentos con usuarios externos y la integración con otros servicios. Esta versión se diseñó claramente pensando en equipos distribuidos y entornos híbridos.

• Opción de compartir archivos y carpetas mediante enlaces públicos para usuarios externos, lo que facilita colaborar con clientes, proveedores o colaboradores sin crearles cuentas internas.
• Posibilidad de conectar almacenamientos de terceros como Google Drive, OneDrive, Box, Dropbox, kDrive, Nextcloud, ownCloud, etc., a tus salas públicas, centralizando el acceso a todo tu contenido.
• Soporte para ver, crear y editar archivos Markdown, muy útil para documentación técnica, notas y contenidos ligeros.
• Herramientas para crear y administrar grupos de usuarios, lo que simplifica la asignación de permisos en salas y documentos.
• Preajustes para incrustar DocSpace o partes del mismo en cualquier interfaz web, integrándolo en intranets, portales corporativos o aplicaciones propias.
• Asistente para importar datos desde ONLYOFFICE Workspace, Google Workspace y Nextcloud, evitando migraciones dolorosas.
• Configuración de cuotas de almacenamiento por sala o por usuario, con el fin de controlar el consumo de espacio en disco.
• Capacidad de crear múltiples DocSpaces dentro de la misma infraestructura y hacerlos accesibles a diferentes grupos de usuarios.

Si quieres profundizar en todos estos cambios, la documentación oficial y los vídeos de presentación amplían detalles, pero con este resumen ya se ve que la actualización a 2.5 es especialmente recomendable si trabajas con muchos usuarios externos o diversas fuentes de almacenamiento.

Cómo actualizar un DocSpace autoalojado (Enterprise Edition)

Si tienes instalada una instancia local de ONLYOFFICE DocSpace Enterprise Edition en un servidor propio, puedes actualizarla a 2.5 (u otra versión posterior) sin demasiadas complicaciones utilizando el script oficial de instalación, que también sirve para actualizar.

El truco está en usar el parámetro -u del script, que por defecto viene a false, y cambiarlo a true para que en lugar de instalar desde cero, el script proceda a detener contenedores existentes, eliminarlos y levantar los nuevos con las versiones actualizadas de cada componente.

Para actualizar toda la suite DocSpace Enterprise de golpe, puedes usar este comando general:

bash docspace-enterprise-install.sh -u true

Este comando se encarga de detener los contenedores necesarios, borrarlos y ejecutar las versiones más recientes de todos los componentes de ONLYOFFICE DocSpace Enterprise. Es una forma bastante cómoda de asegurarse de que todos los servicios quedan sincronizados a la misma versión.

Si, por el contrario, deseas actualizar solo el componente DocSpace y dejar el resto tal cual, puedes lanzar algo más específico, por ejemplo:

bash docspace-enterprise-install.sh -u true -dsv v2.5.0 -idocs false -irbt false -irds false

En este caso, el parámetro -dsv se refiere de forma explícita a la versión de DocSpace que quieres instalar (por ejemplo, v2.5.0), mientras que los flags -idocs, -irbt e -irds a false indican que no se actualicen otros componentes como Docs, RabbitMQ o servicios relacionados con almacenamiento.

La documentación oficial de DocSpace detalla qué hace cada parámetro y cómo coordinar la actualización entre todos los componentes, algo especialmente importante si tienes integraciones con otros sistemas o personalizaciones específicas.

Instalar ONLYOFFICE DocSpace si aún no lo tienes en tu servidor

Si todavía no has dado el salto a DocSpace y quieres montarlo por primera vez, el proceso es distinto al de actualización, pero merece mencionarse porque muchas veces se mezcla la instalación inicial con la puesta al día de versiones.

Para desplegar DocSpace en un servidor propio (Windows o Linux) tienes que descargar el paquete correspondiente desde la página oficial de ONLYOFFICE, donde se ofrecen los instaladores para cada sistema operativo y, en muchos casos, scripts automatizados.

Una vez descargado el instalador adecuado para tu entorno, solo tienes que seguir los pasos del asistente o del script, dependiendo de si estás en Windows o Linux/Docker. Cuando la instalación esté completa, en futuras ocasiones podrás actualizar tu DocSpace local usando el mismo mecanismo que hemos visto con el parámetro -u en true.

En definitiva, si estás montando DocSpace desde cero, conviene empezar directamente con la última versión disponible para ahorrarte procesos de actualización inmediatos justo después de la instalación.

Actualizar ONLYOFFICE Mail Server basado en Docker

El componente de correo de ONLYOFFICE suele desplegarse como contenedor Docker. Para actualizarlo correctamente sin perder datos, es fundamental asegurarse de que todos los volúmenes de datos están bien montados y que se vuelven a utilizar exactamente las mismas rutas al recrear el contenedor con la nueva imagen.

El procedimiento estándar de actualización para ONLYOFFICE Mail Server se puede dividir de forma clara en varios pasos: comprobar los volúmenes, eliminar el contenedor viejo, eliminar la imagen antigua, ejecutar la nueva imagen y volver a conectar Docs y Community Server.

Paso 1: Verificar los volúmenes externos de almacenamiento

Primero necesitas revisar que los volúmenes de Docker donde se guarda la información del correo estén correctamente montados. Para ello puedes usar un comando similar a este, sustituyendo el identificador del contenedor correspondiente:

sudo docker inspect --format='{{range $p,$conf:=.HostConfig.Binds}}{{$conf}};{{end}}' {{MAIL_SERVER_ID}}

En este comando, {{MAIL_SERVER_ID}} representa el nombre o el ID del contenedor de ONLYOFFICE Mail. Revisando la salida verás las rutas de los volúmenes que se están utilizando para guardar logs, bases de datos y datos de correo.

Como medida de seguridad adicional, es buena idea hacer una copia de seguridad de las carpetas montadas que residen en la máquina host, por ejemplo:

• /app/onlyoffice/MailServer/logs
• /app/onlyoffice/MailServer/mysql
• /app/onlyoffice/MailServer/data
• /app/onlyoffice/MailServer/data/certs

Con esto te garantizas que, si algo se tuerce durante la actualización, siempre podrás restaurar la información crítica del servidor de correo sin dramas.

Paso 2: Eliminar el contenedor actual

Una vez comprobados y respaldados los datos, llega el momento de eliminar el contenedor de correo que está en ejecución. Esto no borra la información de los volúmenes, solo detiene y borra el contenedor en sí:

sudo docker rm -f {{MAIL_SERVER_ID}}

Recuerda que {{MAIL_SERVER_ID}} sigue siendo el nombre o el ID del contenedor de ONLYOFFICE Mail. Este paso deja libre el nombre del contenedor y evita posibles conflictos con la versión nueva.

Paso 3: Borrar la imagen antigua de ONLYOFFICE Mail

Si no eliminas la imagen anterior, Docker podría reutilizarla y no se produciría realmente una actualización del software de correo. Para forzar la descarga de la última imagen debes hacer algo como esto:

sudo docker rmi -f $(sudo docker images | grep onlyoffice/mailserver | awk '{ print $3 }')

Con este comando te aseguras de que cualquier imagen etiquetada como onlyoffice/mailserver desaparece de tu sistema, y en la siguiente ejecución Docker descargará la versión más reciente disponible en el registro.

Paso 4: Ejecutar la nueva imagen con las mismas rutas de mapa

Antes de lanzar el nuevo contenedor, revisa si ya tienes creada una red Docker llamada onlyoffice. Si no existe, puedes crearla con:

docker network create --driver bridge onlyoffice

Después, ya sí, ejecuta el nuevo contenedor del servidor de correo ONLYOFFICE utilizando las mismas rutas de volúmenes que tenías antes, algo parecido a esto:

sudo docker run --net onlyoffice --privileged -i -t -d --restart=always --name onlyoffice-mail-server \
-p 25:25 -p 143:143 -p 587:587 \
-v /app/onlyoffice/MailServer/data:/var/vmail \
-v /app/onlyoffice/MailServer/data/certs:/etc/pki/tls/mailserver \
-v /app/onlyoffice/MailServer/logs:/var/log \
-v /app/onlyoffice/MailServer/mysql:/var/lib/mysql \
-h yourdomain.com \
onlyoffice/mailserver

Aquí, yourdomain.com es el nombre de host del servidor de correo ONLYOFFICE. Este dominio debe ser válido y apuntar a la dirección IP de la máquina donde está instalado el Mail Server mediante un registro A en tu DNS.

Además, este dominio suele aparecer en el registro MX del dominio que usas para correo, con un formato del tipo mx1.onlyoffice.com. Lo importante es que, al recrear el contenedor, vuelvas a especificar exactamente las mismas rutas de los volúmenes, para que la nueva imagen recoja todos los datos existentes de buzones, certificados y bases de datos.

Paso 5: Volver a ejecutar Docs y Community Server con las mismas rutas

Una vez que el servidor de correo está actualizado, toca revisar los otros componentes de tu ecosistema ONLYOFFICE, como ONLYOFFICE Docs y ONLYOFFICE Community Server, que también suelen funcionar en contenedores Docker.

Debes lanzar un nuevo contenedor de ONLYOFFICE Docs y, después, el contenedor de ONLYOFFICE Community Server, conectándolos tal y como recomiendan las guías oficiales, y montando las carpetas de datos exactamente igual que en la versión anterior.

Cuando todo esté de nuevo en marcha, es momento de entrar al portal, revisar que el correo envía y recibe bien, y comprobar que los datos históricos siguen intactos. Si has respetado los volúmenes, la actualización debería ser transparente para los usuarios.

Actualizar ONLYOFFICE Workspace desde el Panel de Control

Si usas ONLYOFFICE Workspace con panel web, la forma más cómoda de mantenerte al día es a través del propio Control Panel integrado en el portal. Ahí se centralizan las versiones disponibles de cada módulo online y las opciones de descargar e instalar actualizaciones.

Para acceder al Panel de Control, entra a tu portal con una cuenta con permisos de administración y haz clic en el enlace correspondiente en la página de inicio. También puedes ir a la sección de Configuración del portal y localizar el acceso al Control Panel en el menú lateral.

Dentro del apartado de actualizaciones verás la lista de componentes, con su versión actual y la versión disponible en el servidor de ONLYOFFICE. Cuando detectes una actualización, normalmente aparecerá un botón de DOWNLOAD para descargar los archivos necesarios.

Una vez que la descarga termine, ese botón de descarga se convertirá en un botón de UPDATE. En entornos Windows, por ejemplo, el instalador suele guardarse en la carpeta de descargas (Downloads) y tendrás que ejecutarlo manualmente para cada componente que quieras actualizar.

Cuando pulses el botón UPDATE, se mostrará una ventana de aviso informando de que el portal y el Control Panel se reiniciarán y quedarán temporalmente inaccesibles. Si aún no has hecho copia de seguridad puedes cancelar la operación, pero si pulsas en OK se inicia el proceso de instalación de la nueva versión, que puede tardar alrededor de cinco minutos.

Al terminar, las columnas de Current y Available en la página de actualización mostrarán la misma versión para el componente actualizado. Desde ahí puedes volver al portal principal (GO TO PORTAL) y empezar a probar las nuevas características del módulo.

ONLYOFFICE Docs 9.3: por qué te interesa actualizar

En el caso de ONLYOFFICE Docs, las versiones recientes como la 9.3 traen un conjunto de mejoras muy centradas en la edición avanzada de PDF, las opciones de firma y la experiencia de trabajo con documentos largos o presentaciones.

Entre las mejoras que se anuncian para ONLYOFFICE Docs 9.3 se encuentran funciones como la edición de PDF mejorada, más opciones de firma digital para documentos, una vista multipágina en documentos de texto, un módulo Solver para hojas de cálculo, reproducción de GIF durante las presentaciones, y varias mejoras basadas en inteligencia artificial.

Todo esto convierte a ONLYOFFICE Docs en una suite mucho más potente tanto para entornos de oficina clásicos como para escenarios formativos, jurídicos o técnicos donde se trabaja intensivamente con documentos complejos.

Actualizar ONLYOFFICE Docs Community Edition en Linux

Si estás utilizando ONLYOFFICE Docs Community Edition en Linux, la manera de actualizar a la última versión depende de si empleas el script de instalación/actualización o si prefieres un procedimiento manual con paquetes DEB/RPM y gestión de dependencias.

La versión Community para distribuciones Linux y el código fuente se encuentran disponibles públicamente, y la política de soporte de ONLYOFFICE es clara: se ofrece soporte solo para la última versión estable, que suele incluir correcciones de errores y nuevas funciones. Por eso recomiendan actualizar en cuanto sea razonable.

Hay un detalle importante: a partir de la versión 4.1, ONLYOFFICE Docs pasó a utilizar PostgreSQL en lugar de MySQL como base de datos interna. Esto implica que los procedimientos de actualización estándar se aplican desde la 4.1 en adelante, pero no sirven para versiones anteriores que aún dependían de MySQL.

Preparar ONLYOFFICE Docs para el apagado

ONLYOFFICE Docs tiene un comportamiento particular: guarda los cambios de un documento cuando todos los usuarios que lo están editando lo cierran. Para evitar pérdida de datos al apagar el servicio durante una actualización, es necesario forzar la desconexión de los usuarios.

Para ello, la propia suite proporciona un script específico que debes ejecutar antes de detener el servicio:

documentserver-prepare4shutdown.sh

La ejecución de este script puede tardar hasta unos cinco minutos, porque se encarga de desconectar sesiones, consolidar cambios y dejar los documentos en un estado seguro para el apagado. No conviene saltarse este paso si quieres evitar sorpresas.

Actualizar ONLYOFFICE Docs en Linux usando el script

La vía más directa para actualizar ONLYOFFICE Docs en entornos Linux consiste en utilizar el script oficial de instalación, que también admite modo actualización mediante un parámetro similar al que veíamos en DocSpace.

Para empezar, descarga el script desde el repositorio oficial con un comando del estilo:

curl -O http://download.onlyoffice.com/docs/docs-install.sh

Una vez descargado, puedes lanzar el script con el parámetro de actualización activado:

bash docs-install.sh -u true

Durante el proceso, el instalador te preguntará si quieres, por ejemplo, actualizar desde paquetes DEB/RPM. Si en tu caso estás usando ese sistema de paquetes, puedes indicar la opción adecuada, por ejemplo pulsando N y luego Enter cuando la herramienta así lo requiera, para que proceda con la actualización desde los paquetes que correspondan.

Actualización manual: dependencias y repositorios

Si prefieres controlar cada detalle o tu sistema es más antiguo, puedes seguir un procedimiento manual para actualizar ONLYOFFICE Docs, ocupándote tú mismo de las dependencias y repositorios necesarios.

En distribuciones como Ubuntu 14.04 LTS o posteriores, muchas de las dependencias que requiere ONLYOFFICE Docs suelen instalarse automáticamente cuando actualizas desde los paquetes oficiales. Algunas de las más relevantes son:

• libcurl3
• libxml2
• fonts-dejavu
• fonts-liberation
• ttf-mscorefonts-installer
• fonts-crosextra-carlito
• fonts-takao-gothic
• fonts-opensymbol

En distribuciones muy antiguas, como las anteriores a Ubuntu 14.04, puede que tengas que instalar algunas de estas librerías manualmente para garantizar el correcto funcionamiento de la suite, sobre todo en lo referente a renderizado de fuentes y compatibilidad de documentos.

Si estás actualizando desde la versión 4.1 de ONLYOFFICE Docs, hay que tener en cuenta que quizá necesites añadir el repositorio correcto para la versión específica de Node.js que requiere el sistema. La documentación sugiere algo similar a esto:

curl -sL https://deb.nodesource.com/setup_8.x | sudo bash -

Una vez añadido el repositorio, puedes instalar la versión necesaria de Node.js e iniciar la actualización a la versión más reciente de ONLYOFFICE Docs. Para distribuciones aún más viejas que 14.04, puede que además necesites otras dependencias adicionales, por lo que conviene revisar las notas de versión y los requisitos oficiales antes de actualizar.

Integración de ONLYOFFICE con Nextcloud/ownCloud y edición colaborativa

Una de las grandes bazas de ONLYOFFICE es su capacidad para integrarse con plataformas como Nextcloud u ownCloud, ofreciendo edición colaborativa en tiempo real de documentos directamente en el navegador, muy al estilo de Google Docs pero bajo tu propio control.

ONLYOFFICE permite editar documentos de texto, hojas de cálculo y presentaciones en distintos formatos: por defecto utiliza .docx, pero también se pueden habilitar formatos como .odt, .doc, .ods, .xls, .xlsx, .odp, .ppt o .pptx para trabajar con documentos creados fuera de la aplicación.

En este tipo de despliegue, Nextcloud u ownCloud actúan como interfaz de acceso a los archivos, mientras que ONLYOFFICE se encarga de la edición. En lugar de descargar el documento al hacer clic en él, se abre el editor online en el navegador.

Instalación básica de ONLYOFFICE para integrarlo con Nextcloud/ownCloud

Antes de instalar ONLYOFFICE como servicio independiente para conectarlo con Nextcloud, es importante decidir bajo qué dominio o subdominio lo vas a alojar. Un ejemplo típico sería onlyoffice.mydomain.com, para el cual tendrás que crear un registro DNS A apuntando a la IP del servidor.

Dependiendo del proveedor de dominio, la propagación de los DNS puede tardar desde unos minutos hasta varias horas. Una vez que el dominio resuelve correctamente, puedes pasar a instalar la aplicación desde tu panel de control o desde el entorno que utilices.

En muchas plataformas de hosting, en la sección de “Instalar aplicaciones”, al marcar ONLYOFFICE se muestra un campo en el que debes introducir el dominio o subdominio elegido, como por ejemplo onlyoffice.mydomain.com, así como una contraseña secreta que luego necesitarás para vincular ONLYOFFICE con Nextcloud. Conviene guardarla en un lugar seguro.

Conectar ONLYOFFICE con Nextcloud/ownCloud

Cuando termine la instalación de ONLYOFFICE, el siguiente paso es instalar y configurar la extensión correspondiente desde el panel de administración de Nextcloud u ownCloud. Para ello, inicia sesión con una cuenta administradora y ve a la sección de Aplicaciones, normalmente en la categoría de “Oficina y texto”, y localiza el conector de ONLYOFFICE.

Al pulsar en “Descargar y activar” se añadirá el módulo, y a continuación tendrás que ir al área de Configuración > ONLYOFFICE dentro de Nextcloud para completar los datos.

Los dos campos clave que debes introducir son:

• La URL de instalación del servidor de ONLYOFFICE, incluyendo el https://, por ejemplo https://onlyoffice.mydomain.com.
• La clave secreta que autoriza la conexión entre Nextcloud y ONLYOFFICE, la misma que definiste durante la instalación. Si no la recuerdas, suele poder consultarse o modificarse desde el panel de control del proveedor, en el apartado de gestión de ONLYOFFICE.

En esta misma pantalla podrás activar distintos formatos de archivo adicionales para su edición, ajustando la integración a tus necesidades. A partir de ese momento, cada vez que un usuario acceda a un documento desde la sección de archivos de Nextcloud, se abrirá en el editor de ONLYOFFICE en el navegador.

En muchos despliegues se instala la edición Community de ONLYOFFICE, que tiene ciertas limitaciones, como un máximo de 10 documentos abiertos simultáneamente y alrededor de 20 conexiones activas a la vez. Para entornos más exigentes, se recomienda valorar ediciones comerciales con límites ampliados y soporte dedicado.

En conjunto, mantener ONLYOFFICE bien actualizado —ya se trate de DocSpace, Docs Community Edition, Workspace, el servidor de correo o las integraciones con Nextcloud/ownCloud— garantiza no solo nuevas funciones atractivas como mejor gestión de PDF, conectores con nubes externas o vistas multipágina, sino también más seguridad, menos errores y una experiencia de colaboración mucho más fluida para todos los usuarios que dependen a diario de la plataforma.