Impeça o servidor de documentos ONLYOFFICE de ficar sem memória VPS.

Se o servidor de documentos ONLYOFFICE travar ou reiniciar devido à falta de memória no seu VPS, primeiro confirme se houve um evento de falta de memória e verifique se o limite de memória do Docker está insuficiente. Em seguida, forneça RAM física suficiente para a carga de trabalho e adicione swap apenas como uma margem de segurança; reiniciar o editor repetidamente não resolverá uma falta persistente de capacidade.

1. Prove que a pressão sobre a memória está causando a falha.

Inicie o processo no VPS Linux, não nas configurações de integração do ONLYOFFICE. Uma mensagem do navegador como "Não foi possível carregar o documento" também pode ser causada por problemas de rede ou autenticação, portanto, é importante verificar se o mecanismo de encerramento de processos por falta de memória (OOM kill) do Linux realmente finalizou algum processo.

Execute esses comandos via SSH. Substitua `< onlyoffice-document-servernome do contêiner>` pelo nome do contêiner exibido por docker ps -a:

free -h
docker ps -a
docker stats --no-stream onlyoffice-document-server
docker inspect --format '{{.State.OOMKilled}} {{.State.ExitCode}} {{.HostConfig.Memory}} {{.HostConfig.MemorySwap}}' onlyoffice-document-server

free -hMostra a RAM e o swap disponíveis no host. docker statsMede um contêiner em execução, enquanto o comando `inspect` reporta o estado em que o contêiner foi encerrado por falta de memória (OOM killed), o último código de saída e os limites de recursos configurados em bytes. Um HostConfig.Memoryvalor diferente de zero indica um limite de memória explícito. As estatísticas de memória do Docker podem excluir certos caches de arquivos, portanto, devem ser comparadas com as medições do host, em vez de serem consideradas como um retrato completo. Consulte a referência de estatísticas do Docker .

Se o contêiner foi interrompido, docker statsnão será possível exibir seu pico anterior. Em vez disso, verifique o log do kernel e as mensagens recentes do aplicativo:

sudo journalctl -k --since "-2 hours" | grep -Ei 'out of memory|killed process|oom'
docker logs --tail 100 onlyoffice-document-server

Mensagens do kernel mencionando "Memória insuficiente" ou "Processo encerrado" ajudam a identificar o processo envolvido. OOMKilled=trueIsso é uma forte evidência de um evento de falta de memória no contêiner, mas falsenão descarta a possibilidade de o kernel do host encerrar um processo filho enquanto o contêiner permanece em execução. Da mesma forma, o código de saída 137 apenas confirma o encerramento por sinal SIGKILL, não sua causa. Se não houver evidências de falta de memória, investigue os logs e falhas de conexão antes de comprar mais memória RAM.

2. Aloque RAM suficiente ao VPS antes de ajustar qualquer outra configuração.

Em outubro de 2026, o arquivo README do servidor de documentos Docker oficial da ONLYOFFICE listava 4 GB ou mais de RAM e pelo menos 2 GB de swap entre os requisitos recomendados. A documentação separada do instalador oficial de um clique identifica 4 GB de RAM para ambientes de teste Docker, recomenda 8 GB ou mais para produção e especifica pelo menos 4 GB de swap em seus requisitos de instalação. Esses documentos descrevem contextos de implantação diferentes, portanto, não interprete 4 GB como garantia de desempenho confiável em produção.

Se o seu VPS tiver apenas 1 a 2 GB de RAM, atualizar o plano de dados é a solução mais segura para uma instalação baseada em Docker. Se já tiver 4 GB, verifique quanto está sendo consumido pelo sistema operacional, banco de dados, proxy reverso, Nextcloud e outros contêineres. Um servidor que parece ter boa capacidade de processamento em repouso pode ficar sem memória quando várias pessoas abrem documentos ou convertem planilhas grandes simultaneamente.

Em servidores com alta demanda, utilize este comando ps aux --sort=-rss | headpara identificar processos que consomem muita memória e repita o processo docker statsdurante uma sessão de edição típica. Reserve espaço para o restante da máquina em vez de alocar toda a RAM disponível exclusivamente para o ONLYOFFICE. Se a demanda contínua exceder a capacidade do servidor, migre os serviços concorrentes ou atualize o VPS; um ajuste no nível do aplicativo não pode criar memória física ausente.

Verifique se o limite de memória do Docker foi atingido acidentalmente.

Os contêineres Docker não possuem um limite de memória rígido por padrão, mas uma implantação pode definir um limite com --memoryo Docker Compose mem_limit. Por exemplo, um limite de 2 GB para contêineres pode causar erros de falta de memória (OOM kills) mesmo quando um host com 8 GB de RAM livre estiver disponível. Verifique o limite real antes de alterá-lo. Se o limite for desnecessariamente baixo, ajuste a configuração original do Docker ou do Compose para um valor justificado por medições e pela capacidade restante do host. Consulte a documentação sobre restrições de recursos do Docker e a especificação do serviço Compose .

Não defina cegamente uma alocação de memória ilimitada em um VPS compartilhado: isso pode expor outros serviços a interrupções por falta de memória (OOM kills) em todo o host. Verifique também --memory-swapas configurações do Docker Compose memswap_limit; o Docker contabiliza a RAM e o swap combinados nessa configuração. Limites iguais de RAM e swap combinados desativam efetivamente o swap para o contêiner. Se você gerencia o ONLYOFFICE com o Compose, faça a alteração no arquivo Compose correspondente para que a configuração seja mantida após a recriação do contêiner.

3. Adicione um buffer de swap se o VPS não o possuir.

A memória swap pode absorver picos temporários de consumo de memória, mas é armazenada em disco e é muito mais lenta que a RAM. Verifique swapon --showisso df -h /primeiro. O exemplo a seguir adiciona um arquivo de swap de 2 GiB a um VPS usando um sistema de arquivos local compatível, como o ext4, quando /swapfileele ainda não existe e o provedor permite o uso de swap:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
swapon --show
free -h

Só torne o novo arquivo de swap persistente após swapona conclusão bem-sucedida. Verifique se grep -F '/swapfile' /etc/fstabjá existe uma entrada com ; caso contrário, adicione-a uma única vez:

echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

A criação de arquivos de swap em sistemas de arquivos Btrfs, sistemas de arquivos de rede e algumas outras configurações requer um tratamento diferenciado. Não execute esses comandos sobre um arquivo de swap existente nem assuma que fallocatefuncionarão em todos os casos. O manual do swapon do Linux explica as restrições do sistema de arquivos. Se o VPS utiliza a memória virtual regularmente sob carga normal de edição, priorize mais RAM em vez de um arquivo de swap maior.

4. Verifique novamente o servidor sob uma carga de trabalho de edição realista.

Alterar um plano de VPS ou habilitar o swap geralmente não exige nenhuma edição na configuração do ONLYOFFICE. Se você alterou uma configuração de implantação do Docker, agende uma manutenção e preserve os pontos de montagem, segredos, caminhos de certificado e configurações de integração existentes ao aplicar as alterações. O arquivo README do Docker do ONLYOFFICE documenta documentserver-prepare4shutdown.shos procedimentos de desligamento planejado e alerta que desconectar os editores pode levar vários minutos. Não recrie ou reinicie um servidor de documentos em uso sem necessidade, pois as alterações não salvas podem ser afetadas.

Quando o serviço estiver pronto, verifique se o contêiner está em execução e inspecione sua memória novamente:

docker ps --filter name=onlyoffice-document-server
docker stats --no-stream onlyoffice-document-server
docker inspect --format '{{.State.OOMKilled}}' onlyoffice-document-server
docker exec onlyoffice-document-server curl -fsS http://localhost:8000/info/info.json

A última verificação utiliza o endpoint de informações internas mostrado na verificação de integridade oficial do Docker Compose da ONLYOFFICE ; execute-a dentro do contêiner, pois a porta 8000 pode não estar publicada no VPS. A resposta do endpoint indica a disponibilidade do serviço, não necessariamente que todas as integrações de armazenamento ou retornos de chamada de salvamento estejam funcionando.

Verifique se o problema de memória foi resolvido.

Reabra um documento pequeno e, em seguida, um documento grande representativo através do seu Nextcloud, ownCloud ou outra integração. Salve uma edição inofensiva e confirme se ela aparece após reabrir o arquivo. Continue monitorando free -hos docker statslogs de erros de memória (OOM) do kernel durante o período de uso que anteriormente causou as falhas.

Uma correção bem-sucedida significa que os documentos normais continuam a abrir e salvar, o uso de memória permanece dentro dos limites do VPS e do contêiner e nenhum novo erro de falta de memória (OOM) é exibido. Se as falhas pararem apenas quando a atividade for baixa, o VPS ainda não tem capacidade suficiente para picos de uso; dimensione a RAM para esses picos em vez de depender da troca contínua de dados. Se a RAM permanecer disponível e nenhuma nova mensagem de falta de memória ocorrer, mas os documentos ainda falharem, direcione a investigação para os logs do ONLYOFFICE, o proxy reverso ou seu conector de armazenamento, em vez de fazer mais alterações na memória.