A failed ONLYOFFICE Document Server removal can leave the service files, configuration, data directories, Docker volumes, or a package manager’s dependency packages behind. The safe way to remove it completely is to identify how it was installed, let ONLYOFFICE close active sessions, remove the matching package or container, and then inspect persistent data and shared services before deleting anything else.
Start with a backup if the server still contains documents, cache files you may need, certificates, or custom configuration. Uninstalling Document Server can disrupt Nextcloud, ownCloud, or another application that connects to it. Also, “remove ONLYOFFICE” does not automatically mean “remove PostgreSQL, Nginx, RabbitMQ, Redis, or shared fonts”: those may serve other software.
Before uninstalling, identify the installation type
Check the package database and Snap first:
dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice
snap list | grep -i onlyoffice
These commands are read-only; a blank result from one package manager does not prove the software is absent if it was installed another way. For Docker, list containers and images:
docker ps -a --format 'table {{.ID}}\t{{.Image}}\t{{.Names}}'
docker image ls | grep -i onlyoffice
If the Linux host runs Docker Compose, locate the compose project and its volume declarations before proceeding. If ONLYOFFICE Docs was installed with Helm on Kubernetes, use the chart’s uninstall instructions instead of the Linux package commands.
How do you remove a DEB or RPM installation?
1. Save work and disconnect users cleanly
For the package installation covered by ONLYOFFICE’s Linux removal guide, run its shutdown preparation script before removing the package:
sudo documentserver-prepare4shutdown.sh
The script closes active sessions and helps ensure documents are saved. ONLYOFFICE says it may take up to five minutes. Schedule this step during a maintenance window and notify connected users first. If the command is not found, confirm the installed package and consult the matching edition’s official removal page rather than substituting an unrelated script.
2. Purge the package on Ubuntu or Debian
For Community Edition, the official package name is onlyoffice-documentserver:
sudo apt purge onlyoffice-documentserver
Package names differ by edition. The official Developer Edition removal guide uses onlyoffice-documentserver-de. Check the exact name shown by dpkg -l and use the matching vendor instructions; do not remove a similarly named package by guesswork.
APT purge removes the package binaries and package configuration, but ONLYOFFICE states that dependencies installed with the package remain. Review what APT proposes before confirming. Avoid running apt autoremove automatically: read the package list first and keep anything used by another service.
3. Remove the RPM package on CentOS or compatible systems
The Community Edition removal page gives this command for CentOS:
sudo yum remove onlyoffice-documentserver
Em sistemas que utilizam DNF, use o nome do pacote relatado pelo RPM e revise a transação proposta antes de confirmar:
sudo dnf remove onlyoffice-documentserver
Diferenças entre edições e repositórios podem alterar o nome do pacote. As instruções oficiais da ONLYOFFICE documentam especificamente o yumcomando para CentOS; verifique o nome do pacote equivalente para sua distribuição antes de remover uma versão Enterprise ou Developer.
O que você deve fazer com os arquivos e dependências restantes?
Se a remoção de pacotes indicar que os diretórios não estão vazios, o ONLYOFFICE listará `/etc/systemd/system` /etc/onlyofficee /var/www/onlyoffice`/etc/systemd/system` como diretórios que podem ser removidos manualmente. Primeiro, inspecione-os e copie qualquer configuração, certificado ou arquivo que você queira manter. Em seguida, somente se o servidor estiver sendo desativado e os diretórios não contiverem dados de outros aplicativos, remova esses caminhos específicos:
sudo rm -rv /etc/onlyoffice /var/www/onlyoffice
Não substitua este comando específico por um caractere curinga, como rm -rf /var/*/onlyoffice*. Verifique o estado restante do serviço e do pacote:
systemctl list-units --type=service | grep -Ei 'onlyoffice|documentserver'
dpkg -l | grep -i onlyoffice
rpm -qa | grep -i onlyoffice
O gerenciador de pacotes pode manter instalados os pacotes Nginx, PostgreSQL, RabbitMQ, Redis e fontes, pois são dependências ou pré-requisitos. Remova-os somente após confirmar que não estão sendo usados por outro aplicativo. No Debian ou Ubuntu, verifique as dependências reversas antes de considerar a remoção de um pacote; em sistemas baseados em RPM, verifique os serviços e pacotes que dependem deles. Se o repositório ONLYOFFICE foi adicionado exclusivamente para este servidor, você pode remover separadamente a entrada do repositório e a chave de assinatura após verificar os arquivos configurados. Não remova um repositório compartilhado ou uma chave usada por outro produto ONLYOFFICE.
Revise também a configuração do seu proxy reverso e firewall. Procure nos arquivos do site Nginx por nomes de host ou destinos de proxy que contenham "ONLYOFFICE" e edite apenas o bloco de servidor dedicado ao Document Server. Preserve os hosts virtuais não relacionados. Os certificados TLS são gerenciados separadamente e ainda podem ser necessários para outros sites.
Como remover uma instalação do Docker?
Primeiro, identifique o projeto ou contêiner Compose exato. Para uma instalação do Compose, acesse o diretório que contém o arquivo Compose relevante e pare o projeto:
docker compose down
Isso remove os contêineres e a rede do projeto, mas os volumes nomeados normalmente são mantidos. Isso é útil caso você precise reinstalar o projeto ou recuperar os dados armazenados. Se sua intenção é a exclusão permanente, inspecione o arquivo Compose e liste os volumes antes de remover qualquer coisa:
docker volume ls
docker inspect <container_name> --format '{{json .Mounts}}'
A imagem Docker oficial do ONLYOFFICE documenta caminhos persistentes, incluindo `/ var/www/html` /var/log/onlyoffice, ` /var/www/onlyoffice/Data/var/www/html` e `/ /var/lib/onlyofficevar/www/html`; os dados do PostgreSQL também podem ser armazenados separadamente. As configurações do Compose podem mapear esses caminhos para volumes nomeados ou diretórios do host. Faça backup de todos os certificados ou dados necessários. Remova apenas os volumes e diretórios montados que você identificou com certeza como pertencentes exclusivamente a esta implantação do Document Server.
Após revisão, um projeto Compose pode remover seus volumes nomeados declarados com o seguinte comando:
docker compose down --volumes
Use este comando somente quando você pretende excluir os dados persistentes desse projeto. Não o execute docker volume prunecomo um atalho; ele pode excluir volumes não utilizados e não relacionados. Para um contêiner iniciado com `--no- docker runcontainer`, pare e remova o contêiner específico e, em seguida, inspecione separadamente seus pontos de montagem e remova apenas os caminhos de dados ou volumes que você escolheu descartar.
docker stop <container_name>
docker rm <container_name>
Por fim, remova a imagem ONLYOFFICE somente se nenhum outro contêiner precisar dela. Use a imagem e a tag exatas relatadas por docker image ls:
docker image rm onlyoffice/documentserver:<tag>
O repositório oficial do Docker explica os caminhos de dados e o uso de volumes da imagem. As montagens reais de um contêiner em execução podem diferir dos padrões, portanto, confie docker inspectno seu arquivo Compose em vez de fazer suposições.
Como desinstalar o pacote Snap?
Se snap listo snap do ONLYOFFICE Docs for exibido, o repositório oficial de snaps documenta a remoção com:
sudo snap remove onlyoffice-ds
Em seguida, verifique snap listnovamente. A remoção de snapshots e a exclusão de snapshots retidos ou dados do usuário são operações distintas; inspecione os snapshots salvos snap savede remova apenas o snapshot do ONLYOFFICE que você pretende descartar. Não exclua dados ou snapshots compartilhados indiscriminadamente.
Verificações finais após a desinstalação
- Confirme se o pacote, Snap ou contêiner que você selecionou não está mais instalado ou em execução.
- Verifique se o URL antigo do Servidor de Documentos não responde mais a partir de uma rede confiável ou do próprio host.
- Verifique se todos os aplicativos conectados foram direcionados para um servidor de documentos substituto ou se o conector foi desativado.
- Analise as configurações do Nginx, firewall, DNS e TLS em busca de entradas específicas do ONLYOFFICE, removendo apenas aquelas que não são mais utilizadas.
- Verifique o uso do disco e a lista de dependências restantes do gerenciador de pacotes. Mantenha bancos de dados compartilhados, proxies, brokers de mensagens e fontes caso outro serviço precise deles.
Se a remoção do pacote falhar, leia a mensagem de erro completa e verifique o estado do pacote antes de tentar forçar a remoção. Um script de manutenção corrompido ou uma atualização interrompida podem exigir reparos específicos para aquele sistema operacional e versão do pacote; forçar a remoção sem diagnóstico pode deixar o estado do gerenciador de pacotes inconsistente. O procedimento de remoção padrão é preferível sempre que funcionar.
Referências oficiais