Instalar ONLYOFFICE com script automático Docker

Este guia mostra como instalar o ONLYOFFICE usando um script automático Docker. Inclui requisitos mínimos, comandos práticos, verificação pós-instalação, exemplos de falhas comuns e alternativas em caso de erro. Siga os passos do mini-playbook e valide com os critérios de aceitação.

O que é o ONLYOFFICE

ONLYOFFICE é uma suíte corporativa de escritório web que integra CRM, gestão de projetos e documentos, edição colaborativa em tempo real, calendário e e‑mail. Em uma linha: três servidores principais — Community Server, Document Server e Mail Server — orquestrados por containers Docker.

Novidades

ONLYOFFICE Community Server 9.0

• Integração com DocuSign para assinaturas eletrônicas.
• Janela de compartilhamento redesenhada com link curto gerado automaticamente.
• Restaurar versão anterior do documento a partir do Histórico de Versões.
• Seções de Tarefas e Discussões nos Projetos redesenhadas, com mais opções de navegação.
• Cópia de tarefas e subtarefas.

ONLYOFFICE Document Server 4.3

• Inserção e edição de notas de rodapé.
• Desfazer no modo de coedição rápida (Fast co-editing).
• Mais idiomas suportados pelo corretor ortográfico.
• Novas fórmulas, estilos de borda e Colar Especial (Paste Special) no Editor de Planilhas.

Requisitos do sistema e dependências

Requisitos de hardware (recomendados mínimas)

• CPU: dual-core 2 GHz ou superior.
• RAM: 6 GB ou mais.
• Disco: pelo menos 40 GB livres.
• Swap adicional: mínimo 6 GB.

Observação: ambientes de produção com muitos usuários simultâneos exigirão mais CPU, RAM e I/O de disco.

Requisitos de software

• Sistema operativo: distribuição Linux amd64 com kernel 3.10 ou mais recente.
• Docker: versão 1.10 ou posterior.

Instalação passo a passo

Siga estes passos no servidor que vai hospedar os containers Docker.

1. Abra o terminal (atalho: Ctrl+Alt+T).

2. Baixe o script automático de instalação:

wget http://download.onlyoffice.com/install/opensource-install.sh

3. Execute o script para instalar o ONLYOFFICE com os editores online integrados:

bash opensource-install.sh -ims false

4. Se precisar instalar também o servidor de e‑mail, informe o domínio registrado no comando:

bash opensource-install.sh -md "yourdomain.com"

O script criará e iniciará os containers Docker necessários e instalará dependências. A primeira inicialização pode demorar alguns minutos.

Verificar e acessar o serviço

• Após a execução, abra um navegador e digite o endereço IP ou o hostname do servidor.

• Complete a inicialização fornecendo um e‑mail e criando uma senha para o administrador.
• A página de login aparecerá quando todos os serviços estiverem prontos.

Quando a instalação falha — problemas comuns e soluções rápidas

• Erro: Docker não encontrado/versão incompatível.

  • Solução: instale/atualize o Docker e reinicie o script.

• Erro: portas ocupadas (80, 443, 5222 etc.).

  • Solução: pare serviços locais que usem essas portas (Nginx, Apache) ou ajuste configurações de proxy reverso.

• Problema: containers reiniciando constantemente.

  • Solução: verifique logs do container com docker logs e corrija variáveis de ambiente ou falta de volumes.

• Problema: domínio e e‑mail não configurados para Mail Server.

  • Solução: verifique registros DNS (MX, SPF), portas SMTP e configuração do domínio ao executar o script com -md.

Importante: leia os logs em /var/log/onlyoffice (ou use docker logs) antes de reinstalar; muitas falhas são de configuração simples.

Alternativas à instalação via script

• Uso de imagens oficiais e docker-compose manual, para maior controle de volumes e redes.
• Instalação manual por pacotes DEB/RPM (se disponível para sua distro).
• Usar o serviço hospedado (ONLYOFFICE cloud) se não quiser gerenciar infraestrutura.

Mini‑metodologia de implantação (resumo prático)

1. Planejar: dimensionamento (CPU/RAM/IO) e domínio.
2. Preparar servidor: kernel compatível, Docker instalado, portas liberadas.
3. Executar script e acompanhar logs.
4. Configurar DNS e e‑mail se necessário.
5. Testar funcionalidade: login, edição colaborativa, envio de e‑mail.

Lista de verificação por função

• Administrador de sistemas:

  • Verificar requisitos, instalar Docker e abrir portas.
  • Fazer backup das configurações e volumes Docker.

• Administrador de TI / Segurança:

  • Habilitar HTTPS (certificados Let’s Encrypt ou ACME).
  • Restringir acessos SSH e definir firewall (ufw/iptables).

• Usuário final:

  • Criar conta, testar edição e compartilhamento de documentos.

Critérios de aceitação

• A página de login do ONLYOFFICE carrega sem erro.
• É possível abrir e editar um documento no editor online.
• Coedição em tempo real funciona entre pelo menos dois navegadores.
• E‑mail (se instalado) envia e recebe mensagens básicas.

Runbook de incidentes breve

1. Identifique o container com falha: docker ps -a.
2. Veja logs: docker logs .
3. Reinicie container: docker restart .
4. Em caso de falha persistente, pare o conjunto: bash opensource-install.sh –stop (ou usar docker-compose down se aplicável) e restaure de backup.
5. Escale recursos (CPU/RAM) se logs apontarem consumo excessivo.

Glossário rápido

• Community Server: interface e módulos (CRM, Projetos, Documentos, Comunidade).
• Document Server: editores online (texto, planilha, apresentações).
• Mail Server: gerencia envio/recebimento de e‑mail quando configurado.
• Container Docker: unidade isolada onde cada serviço roda.

Alternativas e quando não usar este método

• Método falha: se precisar de um cluster Kubernetes com orquestração avançada, prefira deploys baseados em Helm charts.
• Alternativa leve: usar somente o Document Server se não precisar do Community Server.

Links úteis

• Documentação oficial: https://onlyoffice.org
• Código e informações binárias: https://onlyoffice.org
• Suporte e comunidade de desenvolvedores: https://dev.onlyoffice.org

Resumo final

Este tutorial guia a instalação do ONLYOFFICE via script automático Docker, descreve requisitos, comandos, problemas comuns e alternativas. Use a lista de verificação antes da implantação e valide os critérios de aceitação após a instalação. Para ambientes de produção, ajuste recursos e implemente certificados TLS e backups regulares.

Notas

• Mantenha backups dos volumes Docker para evitar perda de dados.
• Atualize o Docker e o kernel do SO periodicamente.