Base de Conhecimento

OnlyOffice na VPS: edite documentos no seu servidor

  • onlyoffice, nextcloud, editor de documentos, docker, vps
  • Usuários acharam útil: 0

ONLYOFFICE Docs 10.0.0: licença AGPL-3.0 com termos adicionais, requisitos, instalação com Docker, JWT e Let's Encrypt, conexão com o Nextcloud, backup e atualização.

Por Redação Eleven Host · @robson.direitodigital · 14 de novembro de 2026 · 9 min de leitura

Arte da Eleven Host: janela de terminal com o título: OnlyOffice na VPS: edite documentos no seu servidor

Capa da Redação Eleven Host para o guia: OnlyOffice na VPS: edite documentos no seu servidor Arte: Eleven Host

OnlyOffice na VPS é o ONLYOFFICE Docs Community rodando no seu servidor: editor de documentos, planilhas e apresentações no navegador, que se liga a um sistema como o Nextcloud por meio de um conector.

Atualizado em 14/11/2026. Os blocos de exemplo pedem conferência no seu servidor antes do uso. O artigo O que é servidor VPS: guia simples para iniciantes explica o que é uma VPS, e Docmost na VPS: documentação da equipe no seu servidor mostra outra ferramenta de equipe no mesmo estilo.

O que é o ONLYOFFICE Docs

O repositório oficial descreve o ONLYOFFICE Docs como uma suíte de escritório colaborativa online, com visualizadores e editores. O README cita editores de texto, planilhas, apresentações, formulários e PDF, e diz que ele se conecta a dezenas de plataformas, como Odoo, Moodle, Nextcloud, ownCloud e Confluence.

O Docs é o servidor de edição. Quem guarda e organiza os arquivos é o sistema ligado a ele, como o Nextcloud, e o conector faz a ponte entre os dois.

Em 14/11/2026, a versão estável é a 10.0.0, de 12/10/2026. Os exemplos abaixo fixam a tag 10.0.0 e deixam as versões 9.x de fora, porque a 10.0 trouxe correções de segurança.

Licença e edições pagas

O ONLYOFFICE Docs está sob a licença AGPL-3.0, com termos adicionais no arquivo LICENSE do repositório. Os termos adicionais tratam de atribuição e de aviso em versões modificadas, e não dão direito de uso da marca, dos logotipos e do nome da ONLYOFFICE. Para o seu caso, leia a licença.

A edição Community é a gratuita. As edições Enterprise e Developer são comerciais, e os valores e as condições ficam com a ONLYOFFICE. Segundo a documentação oficial, a Community deixou de ter limite de conexões simultâneas na versão 9.4. Isso não torna o servidor sem teto: ele precisa estar dimensionado para a equipe que vai usá-lo.

Por que fixar a versão 10.0.0

O changelog da 10.0.0 lista correções de segurança, entre elas falhas de script entre sites (XSS), de leitura de arquivo local na conversão de EPUB e de path traversal. Por esse motivo, os exemplos usam a 10.0.0 ou uma versão mais nova, e não as 9.x. A política de suporte do helpcenter diz que só a última versão estável é suportada. O GitHub não tem avisos de segurança publicados para o projeto, mas isso não significa ausência de falhas.

A 10.0 também mudou comportamentos: o JWT vem ligado por padrão, as regras de ipfilter passaram a ser obrigatórias para o WOPI e as APIs de serviço deixaram de aceitar o token da configuração do editor. O README do DocumentServer recomenda ler as notas da 10.0 antes de atualizar da 9.x.

Requisitos oficiais

Os números abaixo são os do helpcenter de instalação com Docker. Segundo o helpcenter, a ONLYOFFICE recomenda processador de 2 núcleos a 2 GHz ou melhor, 4 GB de RAM ou mais, 4 GB de swap no mínimo (o valor depende do sistema) e 40 GB de espaço livre em disco. O sistema é uma distribuição Linux amd64 com kernel 3.10 ou mais novo, e a imagem também tem versão arm64.

Para planejar o espaço, Quanto de disco precisa uma VPS: como calcular ajuda a somar sistema, imagens e arquivos.

Antes de começar: Docker, subdomínio e portas

Primeiro, instale o Docker pelo caminho oficial. Siga a página do Docker para a sua distribuição (para Ubuntu, docs.docker.com/engine/install/ubuntu), que lista as versões 22.04, 24.04 e 26.04 (LTS) e a 26.10. O helpcenter da ONLYOFFICE aceita as versões que a equipe do Docker suporta.

A descrição de cada VPS da Eleven Host está na loja; confira o que cada plano inclui. Ver as VPS

Depois, escolha um subdomínio para o editor, como office.seudominio.com.br, e crie um registro A no DNS apontando para o endereço da VPS. O certificado HTTPS embutido na imagem é pedido ao Let's Encrypt, e isso exige que o nome já aponte para o servidor e que as portas 80 e 443 estejam abertas antes do primeiro início.

O Docker passa por cima do ufw

A documentação do Docker avisa que as portas publicadas por contêineres ignoram as regras de firewall do ufw e do firewalld. O -p 80:80 do comando oficial publica a porta em todas as interfaces da VPS, então o ufw não a protege.

Subir o ONLYOFFICE Docs com Docker

O comando oficial do helpcenter publica a porta 80 (a 443 entra no caso do Let's Encrypt), guarda os dados fora do contêiner e recebe o segredo do JWT. O exemplo abaixo junta essas partes com a tag 10.0.0 e com as variáveis do Let's Encrypt, com valores fictícios para você trocar. Gere antes o valor do JWT_SECRET com o comando da caixa logo abaixo. Um exemplo de comando, para conferir no seu servidor:

sudo docker run -i -t -d -p 80:80 -p 443:443 --restart=always \

-v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice \

-v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data \

-v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \

-e JWT_SECRET=SEU_SEGREDO_JWT \

-e LETS_ENCRYPT_DOMAIN=office.seudominio.com.br \

-e LETS_ENCRYPT_MAIL=seu@email \

onlyoffice/documentserver:10.0.0

A Community monta três pastas: os logs em /var/log/onlyoffice, os dados em /var/www/onlyoffice/Data e a biblioteca em /var/lib/onlyoffice. As edições Enterprise e Developer montam outras três, porque trazem PostgreSQL, RabbitMQ e Redis embutidos. As variáveis LETS_ENCRYPT_DOMAIN e LETS_ENCRYPT_MAIL são as que o README e o helpcenter descrevem para o certificado embutido. Vale acompanhar a validade do certificado.

Defina o JWT_SECRET

O JWT vem ligado por padrão. Sem definir o JWT_SECRET, a imagem gera um valor aleatório, e o helpcenter explica que ele é gerado de novo a cada reinício da máquina, o que quebra a integração. Por isso o exemplo define o segredo. Um exemplo de comando para gerar um valor forte, de letras e números:

openssl rand -hex 32

Recomendamos guardar esse valor num lugar privado, porque o mesmo segredo vai ser usado no conector. Recomendamos não desligar o JWT para contornar um erro de conexão: o caminho é conferir se os dois lados usam o mesmo segredo. Quem já usa um proxy reverso na frente do Docs deve seguir o arquivo oficial da ONLYOFFICE para essa configuração.

Conferir se está no ar

Com o contêiner rodando, abra https://office.seudominio.com.br no navegador. A página de boas-vindas do ONLYOFFICE Docs deve aparecer. Para checar os editores, a documentação da API manda enviar uma requisição GET a /healthcheck; a resposta deve ser true. No navegador, o endereço é este:

https://office.seudominio.com.br/healthcheck

O serviço de exemplo da imagem, ativado por EXAMPLE_ENABLED, vem desligado por padrão. Recomendamos mantê-lo desligado numa VPS exposta à internet.

Conectar ao Nextcloud

O helpcenter lista os requisitos do conector do Nextcloud: Nextcloud 32 (o conector é compatível até a versão 34), conector ONLYOFFICE 10.1.0 ou mais novo e ONLYOFFICE Docs 7.0 ou mais novo. Há ainda uma condição de rede: o Docs precisa conseguir enviar requisições POST diretamente ao Nextcloud. Antes de atualizar o Nextcloud, confira a compatibilidade na página do conector.

No Nextcloud, abra a loja de apps, procure o app ONLYOFFICE, na categoria Tools, e use o botão para baixar e ativar. Depois, vá em Configurações, Administração, ONLYOFFICE e preencha dois campos: o endereço do ONLYOFFICE Docs, com o endereço do seu editor (https://office.seudominio.com.br), e a chave secreta (Secret key), que deve ser o mesmo valor do JWT_SECRET do contêiner.

A seção de configurações avançadas traz dois endereços para quando a rede não permite usar os endereços públicos: o do Docs para requisições internas do servidor Nextcloud e o do Nextcloud para requisições internas do Docs. A opção que desativa a verificação do certificado é descrita pela ONLYOFFICE como insegura, e a ONLYOFFICE recomenda trocar o certificado. A caixa do servidor de demonstração é pública, e a documentação pede para não enviar dados sensíveis a ele.

A lista de conectores oficiais do helpcenter inclui também WordPress, Moodle, Odoo, ownCloud, Redmine, SuiteCRM, Mattermost e Confluence.

Backup e atualização

A página de atualização do helpcenter pede um backup antes de trocar de versão. Como o docker run acima monta só as pastas data e lib (além dos logs), o exemplo abaixo guarda essas duas. Um exemplo de comando, para conferir no seu servidor:

sudo tar -czf onlyoffice-docs-backup-$(date +%Y%m%d).tar.gz \

/app/onlyoffice/DocumentServer/data \

/app/onlyoffice/DocumentServer/lib

Recomendamos levar a cópia para fora da VPS e mantê-la privada. O README avisa que o documento só é salvo depois que as pessoas o fecham e pede um comando de preparação antes de parar o servidor, que pode levar até 5 minutos. Confira no seu contêiner se o comando de preparação, documentserver-prepare4shutdown, leva ou não o .sh no fim.

Para atualizar, a documentação usa o identificador do contêiner nos comandos (o sudo docker ps mostra o seu), manda parar o contêiner, baixar a imagem nova e subi-la com as pastas mapeadas exatamente como estavam. Um exemplo, trocando a tag pela versão nova; depois, suba o contêiner com o mesmo docker run de antes, só com a tag nova:

sudo docker stop ID_DO_CONTEINER

sudo docker pull onlyoffice/documentserver:NOVA_TAG

Para voltar atrás, a documentação diz que só dá se o contêiner antigo for mantido: pare o novo e inicie o antigo com sudo docker start. Por isso não remova o antigo com docker rm até ter certeza de que não vai precisar dele.

Endereço do editor

O endereço do editor é um subdomínio de um domínio que você já tem ou vai registrar.

Um domínio próprio dá origem ao subdomínio do editor; a busca e o registro ficam na loja da Eleven Host. Buscar domínio

Perguntas frequentes

O ONLYOFFICE Docs Community é gratuito?

Sim, a edição Community é a gratuita, sob a AGPL-3.0 com termos adicionais de atribuição e de marca. Enterprise e Developer são pagas.

Qual versão instalar?

Em 14/11/2026, a 10.0.0, que traz correções de segurança em relação à 9.x. A tag fixa evita atualizações por engano.

O que preciso para conectar ao Nextcloud?

O app ONLYOFFICE no Nextcloud, o endereço do Docs e a chave secreta igual ao JWT_SECRET do contêiner.

Como o HTTPS é configurado?

Pelo Let's Encrypt embutido na imagem, com o subdomínio apontado e as portas 80 e 443 abertas.

Esta resposta lhe foi útil?

Artigos Relacionados