Como configurar o espaço de trabalho ONLYOFFICE no Ubuntu 24.04 LTS

O ONLYOFFICE Workspace combina a edição de documentos online com um portal de colaboração mais abrangente. No Ubuntu 24.04 LTS, a configuração de servidor mais acessível é usar o script de instalação oficial da comunidade ONLYOFFICE Workspace com o Docker. O Docker executa os componentes do Workspace em contêineres isolados, o que torna a implantação mais fácil de reproduzir e atualizar do que uma instalação construída manualmente.

Este guia utiliza a edição Community e começa com uma opção prática para administradores iniciantes: instalar o Workspace sem o servidor de e-mail opcional ONLYOFFICE. Isso elimina os requisitos de DNS e entrega de e-mail da primeira instalação. Você pode adicionar o serviço de e-mail posteriormente, pelo Painel de Controle, se necessário.

A partir de outubro de 2026, o Docker oferece suporte oficial ao Ubuntu 24.04 LTS (Noble). A documentação atual do Workspace Community da ONLYOFFICE lista um host Linux amd64 com pelo menos uma CPU de 4 núcleos, 8 GB de RAM, 40 GB de espaço livre em disco e 6 GB de swap. O fornecedor recomenda mais CPU e RAM para uma implantação mais tranquila. Consulte o guia de instalação do Docker do Workspace Community da ONLYOFFICE e a documentação de instalação do Docker para Ubuntu antes de implantar em um servidor de produção.

O que você precisa antes de começar

Você precisa de um servidor ou máquina virtual Ubuntu 24.04 LTS, uma conta com sudoprivilégios, acesso à internet para baixar pacotes e imagens de contêineres e recursos livres suficientes para os serviços do Workspace. Se desejar que o portal seja acessível a partir de outros computadores, o servidor também precisa de um endereço de rede local (LAN) estável ou um endereço IP público.

amd64 refere-se à arquitetura de servidor x86 de 64 bits comum usada pelos processadores Intel e AMD. Não presuma que o suporte do Docker para outra arquitetura signifique automaticamente que o ONLYOFFICE Workspace a suporte; os requisitos atuais do Workspace mencionam especificamente o Linux amd64.

Passo 1: Confirme se o host Ubuntu possui recursos suficientes.

Abra o Terminal ou conecte-se ao servidor via SSH. Execute:

uname -m
free -h
df -h

uname -mRelata a arquitetura do processador. Em um host x86-64 compatível, você normalmente verá x86_64. free -hmostra a RAM e a troca (swap), enquanto df -hmostra o espaço livre em disco em unidades legíveis para humanos.

Evite continuar em um servidor que já esteja com pouca memória ou armazenamento. A instalação pode ser concluída, mas falhar posteriormente durante tarefas de edição ou indexação, o que é mais difícil de diagnosticar do que corrigir a capacidade primeiro.

Passo 2: Instale o Docker Engine a partir do repositório oficial do Docker para Ubuntu.

O Docker Engine é o serviço que cria e executa os contêineres usados ​​pela implantação do Workspace. As instruções atuais do Docker para Ubuntu são compatíveis com o Ubuntu 24.04 LTS e recomendam o uso do repositório APT do próprio Docker para uma instalação normal em um servidor.

Primeiro, instale as ferramentas básicas do repositório:

sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings

Adicione a chave de assinatura e o repositório atuais do Docker:

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg   -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

Em seguida, instale o Docker Engine e o plugin Compose:

sudo apt install -y docker-ce docker-ce-cli containerd.io   docker-buildx-plugin docker-compose-plugin

Confirme se o serviço está em execução:

sudo systemctl status docker --no-pager

Etapa 3: Verifique o Docker antes de usar o ONLYOFFICE

Essa pequena verificação diferencia problemas do Docker de problemas do Workspace. Execute:

sudo docker run --rm hello-world

O Docker baixa uma pequena imagem de teste, inicia um contêiner, exibe uma mensagem de confirmação e encerra. Se isso falhar, corrija o Docker primeiro, em vez de continuar com o script do Workspace.

Um erro comum entre iniciantes é tratar um erro de permissões como dockeruma falha do SOMENTE NO ESCRITÓRIO. Este guia usa o usuário `<nome_do_usuário>` intencionalmente sudo docker, então você não precisa adicionar sua conta ao grupo do Docker. O Docker alerta que a participação nesse grupo concede, na prática, controle de nível root, portanto, não adicione usuários indiscriminadamente apenas para encurtar comandos.

Passo 4: Baixe o instalador oficial do ONLYOFFICE Workspace.

A ONLYOFFICE disponibiliza um script de instalação em seu próprio domínio de download. Faça o download diretamente:

curl -O https://download.onlyoffice.com/install/workspace-install.sh

Antes de executar qualquer script administrativo baixado, é uma boa prática inspecioná-lo:

less workspace-install.sh

Pressione qpara sair less. Isso não prova que um script é seguro, mas lhe dá a oportunidade de verificar a origem e observar comandos inesperados antes de conceder privilégios de administrador.

Etapa 5: Instale o Workspace sem o servidor de e-mail primeiro.

Para uma primeira implementação, execute o script oficial, ignorando o ONLYOFFICE Mail:

sudo bash workspace-install.sh -ims false

O -ims falseparâmetro significa “não instalar o componente Servidor de E-mail”. Isso mantém a configuração inicial focada no portal do Workspace, editores de documentos e componentes de administração. Somente documentos do OFFICE podem ser instalados posteriormente pelo Painel de Controle.

Se você já possui um domínio de serviço de e-mail configurado corretamente e deseja especificamente a instalação completa, a ONLYOFFICE fornece este formulário:

sudo bash workspace-install.sh -md "mx1.example.com"

Substitua mx1.example.compelo nome de host real do seu serviço de e-mail. O nome de host deve ser resolvido para o servidor e o domínio de e-mail precisa dos registros DNS apropriados. Não use um nome de host fictício apenas para que o instalador continue. Um DNS incorreto é uma das maneiras mais fáceis de transformar uma implantação do Workspace bem-sucedida em um problema de entrega de e-mails.

Etapa 6: Verifique se os contêineres estão realmente em execução.

Quando o script terminar, inspecione os contêineres em execução:

sudo docker ps

Não se preocupe se os nomes dos seus contêineres forem diferentes dos exemplos que você vê online. Os nomes e os componentes internos podem mudar entre as versões. Os sinais úteis são que os contêineres ONLYOFFICE esperados estão presentes e seu status é "em execução", em vez de reinicializações ou encerramentos repetidos.

Se um contêiner continuar reiniciando, inspecione o nome real docker ps -ae execute o seguinte comando:

sudo docker logs --tail 100 CONTAINER_NAME

Substitua CONTAINER_NAMEpelo nome exibido pelo Docker. Isso é mais seguro do que copiar o nome de um contêiner antigo de um tutorial.

Passo 7: Abra o portal usando o endereço de rede real do servidor.

Encontre os endereços do servidor com:

hostname -I

A partir de um navegador que consiga acessar o servidor, abra:

http://SERVER_IP

O guia do Docker da ONLYOFFICE recomenda especificamente o uso do endereço IP da rede da máquina em vez de `http: localhost//` 127.0.0.1ao verificar o portal. A inicialização pode levar alguns minutos após a instalação, portanto, um pequeno atraso não significa automaticamente que a implantação falhou.

Etapa 8: Conclua a configuração do administrador

Na página inicial, você deverá criar a conta de administrador do portal. Defina uma senha forte, insira um endereço de e-mail válido, selecione o idioma e o fuso horário corretos e aceite os termos da licença. A ONLYOFFICE informa que a política de senha padrão exige entre 8 e 120 caracteres; você pode reforçar as configurações de segurança posteriormente.

Após o assistente inicial, confirme se consegue abrir o módulo Documentos e criar um documento de teste. Um login bem-sucedido por si só comprova que o portal está acessível; abrir e editar um documento também verifica se o componente de edição de documentos está conectado corretamente.

Proteja a instalação antes de convidar usuários.

Se o servidor for usado além de um ambiente de laboratório temporário, migre de HTTP simples para HTTPS. O Painel de Controle do ONLYOFFICE pode gerar e aplicar um certificado Let's Encrypt ou aceitar um certificado e chave privada existentes. Para o fluxo de trabalho Let's Encrypt integrado, a porta 80 deve estar acessível durante a emissão do certificado. Consulte o guia oficial de configuração HTTPS do ONLYOFFICE .

Verifique também quais portas de rede você realmente precisa. O ONLYOFFICE publica uma referência de portas da Comunidade Workspace . Não exponha portas de banco de dados ou de serviços internos à Internet apenas porque elas aparecem nessa tabela.

O Ubuntu inclui o UFW, um firewall de host, mas há uma ressalva importante específica para o Docker: a documentação do Docker alerta que as portas publicadas nos contêineres podem ignorar as regras do UFW. Isso significa que "bloqueei a porta no UFW" não é prova suficiente de que uma porta publicada pelo Docker está inacessível. Analise o comportamento do firewall do Docker e, para um servidor voltado para a Internet, utilize uma política de firewall de host ou upstream adequadamente projetada, em vez de presumir que o UFW sozinho controla todas as portas dos contêineres. A documentação de referência do firewall do Ubuntu está disponível na documentação do firewall do Ubuntu Server .

Problemas comuns e o que verificar primeiro

O instalador diz que uma porta necessária já está em uso.

Verifique os listeners antes de interromper serviços aleatórios:

sudo ss -ltnp | grep -E ':(80|443)\b'

Se o Apache, o Nginx, outro contêiner ou um painel de gerenciamento já estiver utilizando a porta, decida qual serviço deve mantê-la. Não desligue um servidor web de produção sem antes desligá-lo.

O portal não carrega após a instalação.

Verifique primeiro o Docker:

sudo systemctl is-active docker
sudo docker ps -a

Se o Docker estiver inativo, inicie-o e verifique seu registro (log). Se os contêineres do Workspace estiverem ativos, mas a página estiver indisponível, confirme se você está usando o endereço IP correto do servidor e se o roteamento, os grupos de segurança na nuvem e os firewalls upstream permitem o tráfego web necessário.

O servidor fica sem memória durante a instalação.

Verifique novamente free -h. O guia baseado em scripts do Workspace espera pelo menos 6 GB de swap e lista 8 GB de RAM como o mínimo. Uma VM muito pequena pode ficar instável enquanto várias imagens são inicializadas simultaneamente. Migrar para uma VM maior geralmente é uma solução mais adequada do que tentar ajustar cada serviço em função da memória insuficiente.

Você precisará do ONLYOFFICE Mail mais tarde

Você não precisa reinstalar o Workspace. A ONLYOFFICE documenta como adicionar o Servidor de E-mail pela página de Atualização do Painel de Controle. Antes de prosseguir, prepare um nome de host válido para o serviço e seus registros DNS. Consulte o guia da ONLYOFFICE sobre como adicionar o serviço de E-mail a uma instalação existente do Workspace .

Você prefere o Docker Compose em vez do script de instalação?

Essa é uma alternativa válida quando você deseja mais controle sobre a definição de implantação. As instruções atuais do ONLYOFFICE para o Docker Compose exigem a versão 2.16.0 ou posterior para Ubuntu 22.04 e versões posteriores, e instruem os administradores a habilitar a cgrouplinha relevante no arquivo YAML do Workspace. O Ubuntu 24.04 se enquadra na categoria "22.04 e versões posteriores". Siga o guia oficial do ONLYOFFICE para Docker Compose em vez de copiar um arquivo Compose antigo de um tutorial não relacionado.

Como saber se a instalação está realmente concluída

Uma instalação bem-sucedida apresenta vários sinais independentes de funcionamento: o Docker está ativo; os contêineres do Workspace permanecem em execução; o portal abre a partir de outra máquina usando o endereço de rede real do servidor; o administrador consegue fazer login; e um documento de teste abre no editor do navegador. Se você planeja expor o serviço publicamente, o HTTPS também deve funcionar com um certificado confiável pelos navegadores.

Para uma primeira instalação do Ubuntu 24.04, parar após essas verificações é melhor do que adicionar imediatamente serviços de e-mail, proxies reversos personalizados, armazenamento de terceiros e integrações de autenticação. Adicione um recurso por vez, verifique-o e mantenha um registro das alterações de DNS, firewall e contêineres. Isso torna a solução de problemas posterior muito mais previsível.