Como instalar o n8n com Docker Compose em um servidor cloud?
Hospede o n8n em um servidor cloud Linux com acesso root usando Docker Compose, Caddy para HTTPS automático e um volume persistente. O guia também cobre segurança, backup e atualização.
Para instalar o n8n com Docker Compose em um servidor cloud, você precisa de um servidor Linux com acesso root por SSH, Docker e Docker Compose e um subdomínio apontando para o IP do servidor. Depois, crie um docker-compose.yml com Caddy (HTTPS automático) e n8n com volume persistente, rode docker compose up -d e crie o usuário proprietário.
Esta receita serve para qualquer servidor cloud Linux com acesso root. Usamos o Dongee Cloud como exemplo. Os valores de domínio, fuso horário e chave são fictícios, então troque-os pelos seus. As variáveis e os comandos podem mudar entre versões do n8n, por isso consulte a documentação oficial do n8n para a versão que você instalar.
1. Escolha o servidor
Os recursos de que o n8n precisa dependem de quantos fluxos você tem ativos, de com que frequência eles rodam e de quantos dados cada execução movimenta. Alguns poucos fluxos agendados não consomem o mesmo que centenas de webhooks por minuto. O mais prático é começar com um servidor modesto e acompanhar o consumo. No Dongee Cloud, você pode escalar CPU, RAM e disco sem reiniciar nem migrar se o servidor ficar pequeno. Se preferir montar o servidor sob medida, veja o Cloud On Demand e o guia para calcular o preço de um servidor cloud sob medida.
2. Conecte-se por SSH como root
Use o IP do seu servidor e o seu acesso root (o IP do exemplo é fictício):
ssh root@203.0.113.103. Instale o Docker e o Docker Compose
Se o seu servidor usa Ubuntu, siga o guia para instalar o Docker no Ubuntu. Ao terminar, confirme que tudo funciona:
docker --version
docker compose versionSe é a primeira vez que você usa arquivos do Compose, leia antes o que é o Docker Compose.
4. Aponte um subdomínio para o IP do servidor
No painel onde você administra o DNS do seu domínio, crie um registro A com o nome n8n (para ficar n8n.seudominio.com.br) e, como valor, o IP do servidor. Espere a alteração se propagar antes de continuar. O Caddy precisa que o subdomínio já aponte para o seu servidor para obter o certificado HTTPS.
ping n8n.seudominio.com.br5. Crie a pasta e os arquivos
mkdir -p /opt/n8n && cd /opt/n8nArquivo .env
Gere uma chave de criptografia aleatória com openssl rand -hex 32 e cole-a no arquivo. O exemplo abaixo usa valores fictícios:
N8N_HOST=n8n.seudominio.com.br
GENERIC_TIMEZONE=America/Sao_Paulo
N8N_ENCRYPTION_KEY=cole-aqui-a-chave-gerada-com-opensslProteja o arquivo com chmod 600 .env.
Caddyfile
n8n.seudominio.com.br {
reverse_proxy n8n:5678
}docker-compose.yml
services:
caddy:
image: caddy:2
restart: unless-stopped
ports:
- "80:80"
- "443:443"
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddy_data:/data
- caddy_config:/config
depends_on:
- n8n
n8n:
image: docker.n8n.io/n8nio/n8n
restart: unless-stopped
environment:
- N8N_HOST=${N8N_HOST}
- N8N_PORT=5678
- N8N_PROTOCOL=https
- WEBHOOK_URL=https://${N8N_HOST}/
- GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
- TZ=${GENERIC_TIMEZONE}
- N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
volumes:
- n8n_data:/home/node/.n8n
volumes:
n8n_data:
caddy_data:
caddy_config:Repare que o serviço n8n não tem ports. Só o Caddy chega até ele, pela rede interna do Compose. Assim, a porta 5678 nunca fica exposta à internet.
6. Suba o n8n e crie o usuário proprietário
docker compose up -d
docker compose logs -fQuando os logs mostrarem que o n8n está pronto, abra https://n8n.seudominio.com.br no navegador. Na primeira vez, o n8n pede para você criar a conta de proprietário. Faça isso logo, para que ninguém mais a reivindique.
7. Atualize e faça backup
Para atualizar para a imagem mais recente:
cd /opt/n8n
docker compose pull
docker compose up -dAntes de atualizar, leia as notas de versão do n8n, porque algumas versões trazem mudanças incompatíveis. Para fazer backup do volume de dados (descubra o nome exato com docker volume ls; normalmente ele leva o nome da pasta como prefixo):
docker compose stop n8n
docker run --rm -v n8n_n8n_data:/data -v /opt/n8n:/backup alpine \
tar czf /backup/n8n-backup-$(date +%F).tar.gz -C /data .
docker compose start n8nGuarde essa cópia fora do servidor, junto com uma cópia do arquivo .env.
Segurança básica
- Não exponha a porta 5678. Todo o tráfego deve passar pelo proxy com HTTPS.
- Use sempre HTTPS. Pelo n8n passam credenciais de APIs, bancos de dados e contas de terceiros.
- Guarde a N8N_ENCRYPTION_KEY em um lugar seguro. Sem ela, você não consegue recuperar as credenciais salvas no n8n, mesmo tendo o backup do volume.
- Configure um firewall que abra apenas as portas 22, 80 e 443:
ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw enablePor que o Dongee Cloud funciona para esta receita
- Acesso root por SSH, com Docker e Docker Compose sem restrições.
- Processadores Intel Xeon, sem GPU. O n8n não precisa dela.
- Discos NVMe, IP dedicado e implantação em menos de 3 minutos.
- Backup de disco incluído em todos os planos Cloud. O Dongee Backup é um produto à parte e pago.
- 11 localizações: Atlanta, Miami, Nova York, Dallas, México, São Paulo, Santiago, Frankfurt, Madri, Londres e Amsterdã.
- É autogerenciado: quem administra o servidor é você. Você conta com suporte humano 24/7 em português, com tradução em tempo real da plataforma, e assistência para migrar.
Preços mensais: Cloud 1, 17 USD; Cloud 2, 34 USD; Cloud 3, 68 USD; Cloud 4, 136 USD; Cloud 5, 272 USD; Cloud 6, 544 USD; Cloud 7, 1.088 USD. Com o Cloud On Demand, você paga 6 USD por vCPU, 3 USD por GB de RAM e 0,3 USD por GB de disco, com um mínimo de 17 USD por mês.
Comparação honesta: hospedar no Cloud ou usar o plano de n8n
| Critério | n8n auto-hospedado no Dongee Cloud | Plano de n8n da Dongee |
|---|---|---|
| Preço | Cloud 1 a Cloud 7 (17 a 1.088 USD/mês) ou Cloud On Demand com mínimo de 17 USD | A partir de 6 USD |
| Administração do servidor | Fica com você: atualizações, firewall, backups | Veja na página do plano de n8n o que está incluído |
| Controle | Total: root, outros contêineres, Postgres, mais serviços no mesmo servidor | Consulte as condições na página do plano |
| Para quem | Quem sabe administrar Linux e Docker | Quem prefere uma opção pronta para o n8n; veja na página o que está incluído |
Quando esta receita no Dongee Cloud não é para você: se você não quer cuidar de patches, backups e segurança, veja antes o plano de n8n da Dongee (a partir de 6 USD) e o que ele inclui. Se você quer rodar modelos de IA locais junto com o n8n e precisa de GPU, o Dongee Cloud não oferece.
Perguntas frequentes
Posso usar PostgreSQL em vez de SQLite?
Sim. Adicione um serviço de Postgres ao docker-compose.yml e configure no n8n as variáveis de conexão com o banco de dados. Consulte a documentação oficial do n8n para ver as variáveis exatas da sua versão.
O n8n precisa de GPU?
Não. O n8n orquestra fluxos e chama APIs, e funciona bem com CPU. Por isso, um servidor Intel Xeon sem GPU é suficiente.
Como atualizo o n8n?
Entre na pasta do projeto e execute docker compose pull e depois docker compose up -d. Faça backup do volume antes e leia as notas de versão.
O que acontece se eu perder a N8N_ENCRYPTION_KEY?
Seus fluxos continuam no volume, mas você não vai conseguir descriptografar as credenciais salvas e vai ter que inseri-las de novo. Guarde a chave fora do servidor.
O que faço se o servidor ficar pequeno?
No Dongee Cloud, você pode escalar CPU, RAM e disco sem reiniciar nem migrar.
Em resumo
Com um servidor com acesso root, Docker Compose, Caddy e um volume persistente, você coloca o n8n no seu próprio domínio com HTTPS em poucos passos. O mais importante vem depois: guardar a chave de criptografia, fazer backup do volume e manter o servidor atualizado. Se isso não é para você, veja o plano de n8n da Dongee.
Comenta lo que quieras
Unete a la charla
Solo ingresa tu email