Monte uma stack de estudos do n8n com Docker Compose e Traefik

Por Luiz EduardoRevisado em 29 de outubro de 2026

Antes de começar

Subir em uma VPS uma stack de estudos e testes do n8n com Postgres e Traefik, acessível por HTTPS no seu domínio.

VPS com Docker e Compose v2 instalados.
Um subdomínio apontado para o IP da VPS por um registro A.
Portas 80 e 443 livres no servidor.

Esta stack é para estudos e testes em uma VPS. Ela segue o modelo oficial do n8n com Traefik e acrescenta o Postgres, o banco que você encontra na maioria das instalações reais. O Traefik emite o certificado HTTPS sozinho pelo Let’s Encrypt.

Crie a pasta e o arquivo .env

No servidor, crie a pasta n8n-stack e grave este .env dentro dela:

1
# Domínio: o n8n fica em https://SUBDOMAIN.DOMAIN_NAME
2
DOMAIN_NAME=seudominio.com.br
3
SUBDOMAIN=n8n
4

5
# E-mail para o certificado do Let's Encrypt
6
SSL_EMAIL=voce@seudominio.com.br
7

8
# Versão do n8n e fuso dos agendamentos
9
N8N_VERSION=2.45.5
10
GENERIC_TIMEZONE=America/Sao_Paulo
11

12
# Banco Postgres
13
POSTGRES_DB=n8n
14
POSTGRES_USER=n8n
15
POSTGRES_PASSWORD=troque-por-uma-senha-forte
16

17
# Chave que cifra as credenciais
18
N8N_ENCRYPTION_KEY=troque-pela-chave-gerada

Gere a senha e a chave com openssl rand -hex 32 e cole no arquivo. Guarde a chave fora do servidor: sem ela, um backup do banco não abre as credenciais. Proteja o arquivo com chmod 600 .env.

Crie o compose.yaml

1
services:
2
  traefik:
3
    image: traefik:v3
4
    restart: unless-stopped
5
    command:
6
      - "--providers.docker=true"
7
      - "--providers.docker.exposedbydefault=false"
8
      - "--entrypoints.web.address=:80"
9
      - "--entrypoints.web.http.redirections.entryPoint.to=websecure"
10
      - "--entrypoints.web.http.redirections.entrypoint.scheme=https"
11
      - "--entrypoints.websecure.address=:443"
12
      - "--certificatesresolvers.letsencrypt.acme.tlschallenge=true"
13
      - "--certificatesresolvers.letsencrypt.acme.email=${SSL_EMAIL}"
14
      - "--certificatesresolvers.letsencrypt.acme.storage=/letsencrypt/acme.json"
15
    ports:
16
      - "80:80"
17
      - "443:443"
18
    volumes:
19
      - traefik_data:/letsencrypt
20
      - /var/run/docker.sock:/var/run/docker.sock:ro
21

22
  postgres:
23
    image: postgres:18
24
    restart: unless-stopped
25
    environment:
26
      - POSTGRES_DB=${POSTGRES_DB}
27
      - POSTGRES_USER=${POSTGRES_USER}
28
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
29
    volumes:
30
      - postgres_data:/var/lib/postgresql
31
    healthcheck:
32
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
33
      interval: 5s
34
      timeout: 5s
35
      retries: 10
36

37
  n8n:
38
    image: n8nio/n8n:${N8N_VERSION}
39
    restart: unless-stopped
40
    depends_on:
41
      postgres:
42
        condition: service_healthy
43
    labels:
44
      - traefik.enable=true
45
      - traefik.http.routers.n8n.rule=Host(`${SUBDOMAIN}.${DOMAIN_NAME}`)
46
      - traefik.http.routers.n8n.entrypoints=websecure
47
      - traefik.http.routers.n8n.tls.certresolver=letsencrypt
48
      - traefik.http.services.n8n.loadbalancer.server.port=5678
49
    environment:
50
      - DB_TYPE=postgresdb
51
      - DB_POSTGRESDB_HOST=postgres
52
      - DB_POSTGRESDB_PORT=5432
53
      - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
54
      - DB_POSTGRESDB_USER=${POSTGRES_USER}
55
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
56
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
57
      - N8N_HOST=${SUBDOMAIN}.${DOMAIN_NAME}
58
      - N8N_PROTOCOL=https
59
      - N8N_WEBHOOK_URL=https://${SUBDOMAIN}.${DOMAIN_NAME}/
60
      - N8N_PROXY_HOPS=1
61
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
62
      - TZ=${GENERIC_TIMEZONE}
63
      - N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
64
    volumes:
65
      - n8n_data:/home/node/.n8n
66

67
volumes:
68
  traefik_data:
69
  postgres_data:
70
  n8n_data:

O Traefik é o único serviço com portas abertas. Ele redireciona a porta 80 para HTTPS, emite o certificado e entrega o domínio ao n8n na porta interna 5678. O Postgres e o n8n ficam só na rede interna do Compose.

Suba e confira

1
docker compose up -d
2
docker compose ps
3
docker compose logs -f n8n

O n8n espera o Postgres responder ao healthcheck antes de iniciar. Abra o seu subdomínio com HTTPS, como https://n8n.seudominio.com.br. Cadastre o usuário owner. No node Webhook de um workflow de teste, confira se a URL usa o seu domínio com HTTPS.

Recrie o serviço com docker compose up -d --force-recreate n8n e confirme que o workflow continua lá.

Limites desta stack

Ela serve para estudar, testar workflows e validar atualizações. Ela não tem rotina de backup, monitoramento nem plano de recuperação. Antes de guardar algo importante nela, siga o guia de backup.

Para montar ou revisar essa stack com orientação ao vivo, o Desenvolvimento Colaborativo da Dev Side Studio acompanha o trabalho no terminal, com você no controle dos comandos.

Confira o resultado

O subdomínio abre o n8n por HTTPS, o node Webhook mostra a URL pública com o seu domínio e um workflow continua disponível depois de recriar o serviço.

Fontes e conferência

Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.