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.10

3. 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 version

Se é 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.br

5. Crie a pasta e os arquivos

mkdir -p /opt/n8n && cd /opt/n8n

Arquivo .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-openssl

Proteja 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 -f

Quando 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 -d

Antes 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 n8n

Guarde 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 enable

Por 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érion8n auto-hospedado no Dongee CloudPlano de n8n da Dongee
PreçoCloud 1 a Cloud 7 (17 a 1.088 USD/mês) ou Cloud On Demand com mínimo de 17 USDA partir de 6 USD
Administração do servidorFica com você: atualizações, firewall, backupsVeja na página do plano de n8n o que está incluído
ControleTotal: root, outros contêineres, Postgres, mais serviços no mesmo servidorConsulte as condições na página do plano
Para quemQuem sabe administrar Linux e DockerQuem 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