Implante o ONLYOFFICE Docs Enterprise com seu arquivo Compose oficial.

Para uma implantação em um único host, utilize o servidor oficial do ONLYOFFICE, docker-compose.enterprise.ymldisponível no repositório Docker-DocumentServer, e inicie-o com o Docker Compose v2. Antes de colocar o sistema online, substitua as credenciais de exemplo, defina um segredo JWT estável para sua integração e monte o diretório que conterá sua licença Enterprise e os dados persistentes. Um contêiner em execução é apenas a primeira verificação: confirme o status de integridade do Compose e acesse a página de boas-vindas da documentação antes de conectar uma plataforma de produção.

O que inicia o arquivo Enterprise Compose?

O arquivo oficial define o serviço Document Server Enterprise, além das dependências PostgreSQL, RabbitMQ e Redis. Ele publica as portas HTTP e HTTPS do editor e inclui uma verificação de integridade para o endpoint interno de informações do Docs. Essas dependências tornam este arquivo Compose conveniente para uma instalação pequena em um único host; ele não configura, por si só, o conector da sua plataforma, o DNS público ou um certificado TLS de produção.

Conforme verificado em 9 de outubro de 2026, o arquivo oficial utiliza PostgreSQL 15, RabbitMQ 3 e Redis 7. Os arquivos do repositório podem sofrer alterações, portanto, revise o arquivo Enterprise Compose atual antes da implantação e das atualizações.

1. Verifique o host e instale o Docker Compose.

Os requisitos do Docker Enterprise da ONLYOFFICE incluem um host Linux amd64 com kernel 3.10 ou posterior, suporte do Docker pelos seus mantenedores, pelo menos 4 GB de RAM, 40 GB de espaço livre em disco e pelo menos 4 GB de swap. O dimensionamento de referência também varia de acordo com o número de documentos abertos simultaneamente e o tipo de documento; portanto, use esses valores como ponto de partida, não como garantia de capacidade. Um portal de produção com cargas de trabalho mais pesadas pode precisar de mais recursos.

Instale o Docker Engine e o plugin Compose seguindo as instruções oficiais do Docker para sua distribuição Linux. Confirme se ambos os comandos funcionam antes de clonar o repositório:

docker --version
docker compose version

Se o host já possui um servidor web, confirme se as portas 80 e 443 estão disponíveis ou planeje um proxy reverso e um mapeamento de portas diferente no host. O arquivo Compose também inicia os serviços de banco de dados, fila e cache; eles devem permanecer na rede privada do Compose, em vez de serem publicados como portas públicas.

2. Obtenha o arquivo Compose oficial.

Clone o repositório do ONLYOFFICE e acesse o diretório:

git clone https://github.com/ONLYOFFICE/Docker-DocumentServer
cd Docker-DocumentServer

Verifique se docker-compose.enterprise.ymlestá presente. O arquivo README do repositório fornece este comando para a Enterprise Edition:

docker compose -f docker-compose.enterprise.yml up -d

3. Defina as credenciais, o JWT e um local de licença persistente.

Não execute a configuração de exemplo do Compose sem alterações em um host exposto à Internet. O arquivo publicado contém credenciais de banco de dados de exemplo e comenta os valores JWT explícitos. Substitua a senha do PostgreSQL tanto no serviço de banco de dados quanto na DB_PWDconfiguração do Servidor de Documentos pelo mesmo valor forte. Mantenha as portas do banco de dados, do RabbitMQ e do Redis privadas.

Para a integração, defina um segredo JWT estável no serviço Document Server e configure o mesmo segredo no conector ONLYOFFICE da sua plataforma. Uma abordagem simples é manter o valor em um .envarquivo local que você não inclua no Git e, em seguida, usar a substituição de variáveis ​​do Compose. Adicione essas entradas à seção de ambiente do Document Server, adaptando o formato de ambiente existente conforme necessário:

- JWT_ENABLED=true
- JWT_SECRET=${JWT_SECRET}

Insira um valor longo e único em .env`as` JWT_SECRET=.... Não copie o marcador literal para uma configuração ativa. A documentação da ONLYOFFICE indica que o JWT está habilitado por padrão na versão 7.2 e posteriores, com um segredo gerado automaticamente; especificar seu próprio valor estável evita incompatibilidades quando o contêiner for recriado. Consulte o guia de configuração do JWT .

Para registrar o Enterprise com uma licença adquirida license.lic, monte um diretório do host /var/www/onlyoffice/Datano serviço Document Server. Por exemplo, substitua a montagem de dados anônima por ./documentserver-data:/var/www/onlyoffice/Data, crie esse diretório do host e coloque o arquivo license.licdentro dele antes da inicialização. Preserve as permissões do arquivo e mantenha o diretório em seu plano de backup. As instruções de registro do Enterprise confirmam que o arquivo de licença deve estar em uma pasta montada para o Docker.

4. Inicie a pilha Enterprise.

A partir do diretório do repositório, valide a configuração do Compose silenciosamente para que os segredos expandidos não sejam exibidos e, em seguida, inicie os serviços. A validação silenciosa verifica o modelo do Compose; ela não garante que os contêineres serão iniciados. O Docker documenta essa opção em sua referência de configuração do Compose :

docker compose -f docker-compose.enterprise.yml config --quiet
docker compose -f docker-compose.enterprise.yml up -d

A primeira inicialização pode demorar mais enquanto as imagens são criadas ou baixadas e as dependências são inicializadas. Se a validação da configuração reportar uma variável não definida, verifique seu .envarquivo e os nomes das variáveis ​​no arquivo Compose. Não adicione aspas em torno de segredos, a menos que façam parte do valor pretendido.

5. Verifique se tudo está pronto antes de conectar sua plataforma.

Verifique os serviços e o estado de saúde:

docker compose -f docker-compose.enterprise.yml ps

Aguarde a conclusão da verificação de integridade do servidor de documentos. O arquivo Compose oficial realiza verificações http://localhost:8000/info/info.jsondentro do contêiner, com um período de inicialização de 60 segundos. Se o serviço permanecer com status inativo, verifique seus logs e o status das dependências.

docker compose -f docker-compose.enterprise.yml logs --tail=100 onlyoffice-documentserver

Em seguida, abra http://localhosto arquivo no host ou o URL mapeado em um navegador que consiga acessar o servidor. As instruções do Compose da ONLYOFFICE usam a página de boas-vindas como uma verificação inicial da instalação. Para uso remoto em produção, exponha o serviço por meio de HTTPS em seu domínio, em vez de deixar o tráfego do editor em HTTP simples. Consulte o guia de portas do Docker Enterprise e o guia de instalação do Docker ao configurar o acesso à rede e o TLS.

Por fim, configure o URL do servidor de documentos da sua plataforma e o segredo JWT correspondente e, em seguida, abra, edite e salve um documento de teste por meio dessa integração. A página de boas-vindas por si só não comprova que o conector, o proxy reverso, o JWT ou o URL de retorno de chamada estejam configurados corretamente. Se os serviços estiverem funcionando corretamente, mas o editor não conseguir abrir o documento na plataforma, verifique se a plataforma consegue acessar o URL do servidor de documentos e se ambos os lados usam o mesmo segredo JWT e o mesmo cabeçalho. Para uma implantação com vários hosts ou de alta disponibilidade, considere esta pilha do Compose como um ponto de partida e consulte as orientações de implantação da ONLYOFFICE, em vez de presumir que um único host do Compose forneça clustering.