Instalação ONLYOFFICE · 6 min read · Oct 24, 2025

Como Instalar ONLYOFFICE Docs no Ubuntu 24.04

ONLYOFFICE Docs ou Document Server é uma suíte de escritório online que pode ser instalada em seu servidor local. Ele suporta a plataforma de colaboração ONLYOFFICE e sistemas populares como Nextcloud, OwnCloud, WordPress, Drupal, Odoo, SuiteCRM e muitos mais. O ONLYOFFICE Document Server pode ser usado como um editor de documentos, editor de planilhas, editor de apresentações e editor colaborativo. Ele suporta todos os formatos populares: DOC, DOCX, TXT, ODT, RTF, ODP, EPUB, ODS, XLS, XLSX, CSV, PPTX e HTML.

Este guia mostra como implantar o ONLYOFFICE Document Server em um servidor Ubuntu 24.04, com PostgreSQL como banco de dados e Nginx como proxy reverso. Você também irá proteger o ONLYOFFICE Docs com HTTPS através do Certbot e Letsencrypt.

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

  • Um servidor Ubuntu 24.04
  • Um usuário não-root com privilégios de administrador
  • Um nome de domínio apontado para o endereço IP do servidor

Instalando PostgreSQL e RabbitMQ

O ONLYOFFICE Document Server requer PostgreSQL e RabbitMQ instalados em seu servidor Ubuntu. Portanto, agora você instalará ambos os servidores PostgreSQL e RabbitMQ através do repositório oficial do Ubuntu.

Primeiro, execute o seguinte comando para atualizar seu índice de pacotes.

sudo apt update

atualizar repositório

Agora, instale o servidor PostgreSQL e RabbitMQ via o repositório oficial do Ubuntu usando o comando abaixo. Digite ‘Y’ para confirmar a instalação.

sudo apt install postgresql rabbitmq-server

instalar postgresql rabbitmq

Após a instalação ser concluída, verifique o servidor PostgreSQL usando o comando ‘systemctl’ abaixo.

sudo systemctl is-enabled postgresql  
sudo systemctl status postgresql

Você pode ver abaixo que o PostgreSQL está com o status ativo e saído.

verificar postgresql

Por fim, verifique o servidor RabbitMQ com o seguinte comando.

sudo systemctl is-enabled rabbitmq-server  
sudo systemctl status rabbitmq-server

Como visto a seguir, o servidor RabbitMQ também está em execução.

verificar rabbitmq

Criando banco de dados e usuário PostgreSQL

Após o PostgreSQL e RabbitMQ estarem em funcionamento, você criará um novo banco de dados PostgreSQL e um usuário que o ONLYOFFICE Docs usará. Neste exemplo, você usará a linha de comando para criar um banco de dados e um usuário PostgreSQL.

Execute o comando abaixo para criar um novo usuário PostgreSQL ‘onlyoffice‘ com a senha ‘onlyoffice‘.

sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"

Agora crie um novo banco de dados ‘onlyoffice‘ com o proprietário padrão ‘onlyoffice‘ com o seguinte:

sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"

Por fim, verifique a lista de usuários e bancos de dados no servidor PostgreSQL usando o comando abaixo.

sudo -i -u postgres psql -c "\du"  
sudo -i -u postgres psql -c "\l"

Você pode ver abaixo que o usuário ‘onlyoffice‘ e o banco de dados ‘onlyoffice‘ estão disponíveis.

lista de usuários

Instalando o ONLYOFFICE Document Server

Agora que o banco de dados PostgreSQL e o servidor RabbitMQ estão prontos, você pode iniciar a instalação do ONLYOFFICE Document Server. Aqui, você adicionará a chave GPG e o repositório ONLYOFFICE, e então instalará o Document Server através do gerenciador de pacotes APT.

Baixe a chave GPG para o ONLYOFFICE em seu sistema Ubuntu com o seguinte:

curl -fsSL https://download.onlyoffice.com/GPG-KEY-ONLYOFFICE | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/onlyoffice.gpg

Agora execute o comando abaixo para adicionar o repositório ONLYOFFICE para o sistema Debian/Ubuntu.

echo "deb [signed-by=/etc/apt/trusted.gpg.d/onlyoffice.gpg] https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list

adicionar repositório chave gpg

Em seguida, atualize e atualize seu índice de pacotes do Ubuntu e, em seguida, instale o pacote ‘onlyoffice-documentserver‘ com o seguinte comando. Por padrão, o ONLYOFFICE também instalará o servidor web Nginx, que será usado como um proxy reverso.

sudo apt update && sudo apt install onlyoffice-documentserver

Digite ‘Y‘ para prosseguir com a instalação.

instalar onlyoffice docs

Digite a senha do banco de dados PostgreSQL ‘onlyoffice‘.

senha do banco de dados onlyoffice

Selecione OK para aceitar a licença da fonte TTF mscorefont.

aceitar licença mscorefont

Selecione Sim para aceitar os termos da licença EULA.

aceitar eula

Após a instalação ser concluída, o ONLYOFFICE Document Server estará em execução na porta HTTP padrão 80 com o servidor web Nginx.

Verifique o status do servidor web Nginx com o comando abaixo.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Você verá que o servidor web Nginx está em execução.

verificar nginx

Configurando o UFW (Firewall Descomplicado)

Nesta seção, você habilitará o UFW (Firewall Descomplicado) e abrirá portas para os protocolos SSH, HTTP e HTTPS.

Antes de habilitar o UFW, execute o comando abaixo para adicionar perfis para ‘OpenSSH‘ e ‘Nginx Full‘. Isso abrirá a porta 22 para SSH, HTTP e HTTPS para o servidor web Nginx.

sudo ufw allow OpenSSH  
sudo ufw allow 'Nginx Full'

Agora execute o seguinte comando para habilitar o UFW. Digite ‘y‘ para prosseguir e você verá uma saída Firewall está ativo e habilitado na inicialização do sistema.

sudo ufw enable

Por fim, verifique o status do UFW com o seguinte.

sudo ufw status

Você pode ver abaixo que o UFW está com o status ativo e os perfis ‘OpenSSH‘ e ‘Nginx Full‘ estão habilitados.

Protegendo o ONLYOFFICE Document Server com HTTPS

Com o UFW configurado, vamos proteger o ONLYOFFICE Document Server com HTTPS através do Certbot e Letsencrypt. Certifique-se de que seu nome de domínio esteja pronto e apontado para o endereço IP do seu servidor Ubuntu. Se você estiver instalando o ONLYOFFICE Document Server localmente, pode usar certificados autoassinados.

Primeiro, execute o comando ‘systemctl‘ abaixo para parar o servidor web Nginx.

sudo systemctl stop nginx

Agora instale o Certbot com o comando ‘apt‘ abaixo. O Certbot será usado para gerar certificados SSL/TLS gratuitos do Letsencrypt.

sudo apt install certbot -y

Após a instalação ser concluída, execute o comando ‘certbot‘ abaixo para gerar novos certificados SSL para sua instalação do ONLYOFFICE Document Server. Certifique-se de alterar o nome de domínio e o endereço de e-mail com suas informações.

sudo certbot certonly --standalone -m [email protected] --agree-tos --no-eff-email -d office.howtoforge.local

Quando o processo estiver concluído, seus certificados estarão disponíveis no diretório ‘/etc/letsencrypt/live/domain.com‘. O ‘fullchain.pem‘ é a chave pública, e o ‘privkey.pem‘ é sua chave privada.

Em seguida, copie o modelo padrão do Nginx para o ONLYOFFICE para o arquivo ‘/etc/onlyoffice/documentserver/nginx/ds.conf‘.

sudo cp -f /etc/onlyoffice/documentserver/nginx/ds-ssl.conf.tmpl /etc/onlyoffice/documentserver/nginx/ds.conf

Edite o ‘/etc/onlyoffice/documentserver/nginx/ds.conf‘ com o seguinte comando do editor ‘nano‘.

sudo nano /etc/onlyoffice/documentserver/nginx/ds.conf

Altere o ‘ssl_certificate‘ com o caminho do certificado ‘fullchain.pem‘, e o ‘ssl_certificate_key‘ com o caminho do certificado ‘privkey.pem‘.

ssl_certificate /etc/letsencrypt/live/office.howtoforge.local/fullchain.pem;  
ssl_certificate_key /etc/letsencrypt/live/office.howtoforge.local/privkey.pem;

Quando terminar, salve o arquivo e saia do editor.

Agora execute o comando abaixo para verificar a sintaxe do Nginx e garantir que você não tenha erros. Em seguida, inicie novamente o servidor web Nginx com o comando ‘systemctl‘.

sudo nginx -t  
sudo systemctl start nginx

Se você tiver a sintaxe correta do Nginx, verá uma saída como ‘teste bem-sucedido - sintaxe está OK‘.

Por fim, execute o script abaixo para aplicar o HTTPS no ONLYOFFICE Document Server. Com isso, seu ONLYOFFICE estará em execução em conexões HTTPS seguras.

sudo bash /usr/bin/documentserver-update-securelink.sh

configurar https

Verificando a Instalação do ONLYOFFICE Document Server

Visite seu nome de domínio, como https://office.howtoforge.local/, para acessar sua instalação do ONLYOFFICE Document Server. Se for bem-sucedido, você verá a confirmação de que o ONLYOFFICE Docs Community Edition está instalado.

onlyoffice docs instalado

A partir daqui, você pode integrar o ONLYOFFICE Document Server aos seus servidores de arquivos, como Nextcloud e ownCloud, CMS como WordPress e Drupal, ou CRM como Odoo e SuiteCRM.

Conclusão

Parabéns! Você completou a instalação do ONLYOFFICE Document Server em um servidor Ubuntu 24.04. Seu ONLYOFFICE Document Server está em execução com o banco de dados PostgreSQL e o servidor web Nginx. Por fim, você também protegeu o ONLYOFFICE com HTTPS através do Certbot e Letsencrypt.

Share: X/Twitter LinkedIn

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.