Si la desinstalación de ONLYOFFICE Document Server falla, pueden quedar archivos de servicio, configuración, directorios de datos, volúmenes de Docker o paquetes de dependencias del gestor de paquetes. La forma segura de eliminarlo por completo es identificar cómo se instaló, permitir que ONLYOFFICE cierre las sesiones activas, eliminar el paquete o contenedor correspondiente y, a continuación, inspeccionar los datos persistentes y los servicios compartidos antes de eliminar cualquier otro elemento.
Si el servidor aún contiene documentos, archivos de caché que pueda necesitar, certificados o configuraciones personalizadas, comience con una copia de seguridad. Desinstalar Document Server puede interrumpir Nextcloud, ownCloud u otra aplicación que se conecte a él. Además, «eliminar ONLYOFFICE» no implica automáticamente «eliminar PostgreSQL, Nginx, RabbitMQ, Redis o las fuentes compartidas»: estos pueden ser utilizados por otro software.
Antes de desinstalar, identifique el tipo de instalación.
Primero, compruebe la base de datos de paquetes y Snap:
dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice
snap list | grep -i onlyoffice
Estos comandos son de solo lectura; un resultado en blanco de un gestor de paquetes no prueba que el software esté ausente si se instaló de otra manera. Para Docker, liste los contenedores e imágenes:
docker ps -a --format 'table {{.ID}}\t{{.Image}}\t{{.Names}}'
docker image ls | grep -i onlyoffice
Si el host Linux ejecuta Docker Compose, localice el proyecto Compose y sus declaraciones de volumen antes de continuar. Si ONLYOFFICE Docs se instaló con Helm en Kubernetes, utilice las instrucciones de desinstalación del gráfico en lugar de los comandos del paquete de Linux.
¿Cómo se elimina una instalación DEB o RPM?
1. Guarda el trabajo y desconecta a los usuarios correctamente.
Para la instalación del paquete cubierta por la guía de eliminación de ONLYOFFICE para Linux, ejecute su script de preparación de apagado antes de eliminar el paquete:
sudo documentserver-prepare4shutdown.sh
El script cierra las sesiones activas y ayuda a garantizar que los documentos se guarden. ONLYOFFICE indica que puede tardar hasta cinco minutos. Programe este paso durante una ventana de mantenimiento y notifique primero a los usuarios conectados. Si no se encuentra el comando, verifique el paquete instalado y consulte la página oficial de desinstalación de la edición correspondiente en lugar de usar un script no relacionado.
2. Elimine el paquete en Ubuntu o Debian.
Para la edición comunitaria, el nombre oficial del paquete es onlyoffice-documentserver:
sudo apt purge onlyoffice-documentserver
Los nombres de los paquetes varían según la edición. La guía oficial de eliminación de la Edición para Desarrolladores utiliza onlyoffice-documentserver-de. Compruebe el nombre exacto que muestra dpkg -ly siga las instrucciones del proveedor correspondientes; no elimine un paquete con un nombre similar por intuición.
APT purge elimina los binarios y la configuración del paquete, pero ONLYOFFICE indica que las dependencias instaladas con el paquete permanecen. Revise la propuesta de APT antes de confirmar. Evite ejecutarlo apt autoremoveautomáticamente: lea primero la lista de paquetes y conserve todo lo que utilice otro servicio.
3. Elimine el paquete RPM en CentOS o sistemas compatibles.
La página de eliminación de Community Edition proporciona este comando para CentOS:
sudo yum remove onlyoffice-documentserver
En los sistemas que utilizan DNF, utilice el nombre del paquete informado por RPM y revise la transacción propuesta antes de confirmarla:
sudo dnf remove onlyoffice-documentserver
Las diferencias de edición y repositorio pueden modificar el nombre del paquete. Las instrucciones oficiales de ONLYOFFICE documentan específicamente el yumcomando para CentOS; verifique el nombre de paquete equivalente para su distribución antes de eliminar una compilación Enterprise o Developer.
¿Qué debes hacer con los archivos y dependencias restantes?
Si al eliminar el paquete se informa que los directorios no están vacíos, ONLYOFFICE los enumera /etc/onlyofficecomo /var/www/onlyofficedirectorios que se pueden eliminar manualmente. Primero, inspecciónelos y copie cualquier configuración, certificado o archivo que desee conservar. Luego, solo si el servidor se va a retirar y los directorios no contienen datos de ninguna otra aplicación, elimine esas rutas exactas:
sudo rm -rv /etc/onlyoffice /var/www/onlyoffice
No reemplace este comando específico con un comodín como rm -rf /var/*/onlyoffice*. Verifique el estado restante del servicio y del paquete:
systemctl list-units --type=service | grep -Ei 'onlyoffice|documentserver'
dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice
Es posible que el gestor de paquetes deje instalados los paquetes Nginx, PostgreSQL, RabbitMQ, Redis y de fuentes, ya que son dependencias o requisitos previos. Elimínelos solo después de confirmar que no los utiliza otra aplicación. En Debian o Ubuntu, revise las dependencias inversas antes de considerar la eliminación de un paquete; en sistemas basados en RPM, revise los servicios y paquetes que dependen de ellos. Si el repositorio de ONLYOFFICE se agregó exclusivamente para este servidor, puede eliminar por separado su entrada de repositorio y la clave de firma después de revisar los archivos configurados. No elimine un repositorio o clave compartida utilizada por otro producto de ONLYOFFICE.
Revise también la configuración de su proxy inverso y firewall. Busque en los archivos del sitio Nginx los nombres de host o destinos de proxy de ONLYOFFICE y edite únicamente el bloque del servidor dedicado a Document Server. Conserve los hosts virtuales no relacionados. Los certificados TLS se gestionan por separado y es posible que otros sitios los necesiten.
¿Cómo se elimina una instalación de Docker?
Primero, identifique el proyecto o contenedor exacto de Compose. Para una instalación de Compose, cambie al directorio que contiene el archivo Compose correspondiente y detenga el proyecto:
docker compose down
Esto elimina los contenedores y la red del proyecto, pero los volúmenes con nombre normalmente se conservan. Esto resulta útil si necesita reinstalar el sistema o recuperar los datos almacenados. Si su intención es eliminarlo permanentemente, revise el archivo Compose y la lista de volúmenes antes de eliminar nada.
docker volume ls
docker inspect <container_name> --format '{{json .Mounts}}'
La imagen oficial de Docker de ONLYOFFICE documenta rutas persistentes, incluyendo /var/log/onlyoffice, /var/www/onlyoffice/Data, y /var/lib/onlyoffice; los datos de PostgreSQL también pueden almacenarse por separado. Las configuraciones de Compose pueden asignar estas rutas a volúmenes con nombre o directorios del host. Realice copias de seguridad de los certificados o datos que necesite. Elimine únicamente los volúmenes y directorios montados que haya identificado positivamente como pertenecientes exclusivamente a esta implementación de Document Server.
Tras su revisión, un proyecto Compose puede eliminar los volúmenes con nombre declarados mediante:
docker compose down --volumes
Utilice esto únicamente cuando tenga la intención de eliminar los datos persistentes de ese proyecto. No lo ejecute docker volume prunecomo acceso directo; puede eliminar volúmenes no utilizados no relacionados. Para un contenedor iniciado con docker run, detenga y elimine el contenedor específico, luego inspeccione por separado sus puntos de montaje y elimine solo las rutas de datos o los volúmenes que haya elegido descartar:
docker stop <container_name>
docker rm <container_name>
Finalmente, elimine la imagen ONLYOFFICE solo si ningún contenedor restante la necesita. Utilice la imagen y etiqueta exactas informadas por docker image ls:
docker image rm onlyoffice/documentserver:<tag>
El repositorio oficial de Docker explica las rutas de datos y el uso de volúmenes de la imagen. Los puntos de montaje reales de un contenedor en ejecución pueden diferir de los predeterminados, así que confía docker inspecten tu archivo Compose en lugar de hacer suposiciones.
¿Cómo se desinstala el paquete Snap?
Si snap listmuestra el snap ONLYOFFICE Docs, el repositorio oficial de snap documenta la eliminación con:
sudo snap remove onlyoffice-ds
Luego, verifique snap listnuevamente. La eliminación de instantáneas y la eliminación de instantáneas o datos de usuario retenidos son operaciones distintas; inspeccione las instantáneas guardadas snap savedy elimine solo las instantáneas de ONLYOFFICE que desee descartar. No elimine datos o instantáneas compartidas indiscriminadamente.
Comprobaciones finales tras la desinstalación
- Confirma que el paquete, Snap o contenedor al que te dirigiste ya no está instalado ni en ejecución.
- Compruebe que la antigua URL del servidor de documentos ya no responde desde una red de confianza o desde el propio host.
- Verifique que cualquier aplicación conectada esté configurada para usar un servidor de documentos de reemplazo o que se haya deshabilitado su conector.
- Revise la configuración de Nginx, el firewall, DNS y TLS para las entradas específicas de ONLYOFFICE, eliminando únicamente aquellas que ya no se utilicen.
- Verifique el uso del disco y la lista de dependencias restantes del gestor de paquetes. Mantenga las bases de datos compartidas, los proxies, los intermediarios de mensajes y las fuentes si otro servicio los necesita.
Si la eliminación del paquete falla, lea el mensaje de error completo e inspeccione el estado del paquete antes de intentar forzar la eliminación. Un script de mantenimiento defectuoso o una actualización interrumpida pueden requerir una reparación específica para ese sistema operativo y versión del paquete; forzar la eliminación sin un diagnóstico puede provocar que el estado del gestor de paquetes sea inconsistente. El procedimiento de eliminación estándar es preferible siempre que funcione.
Referencias oficiales