n8n
O template n8n instancia um Postgres gerenciado e o serviço n8n ligado a ele. O procedimento de instanciar é o de Templates de 1 clique, com o id n8n e sem parâmetros.
NAME="n8n-$(date +%s)-$RANDOM"H="Authorization: Bearer $NEBULAR_TOKEN"P=$(curl -sS -X POST "$NEBULAR_API/v1/projects" -H "$H" -H "Content-Type: application/json" \ -d "{\"name\": \"$NAME\"}" | jq -r .id)
curl -sS -X POST "$NEBULAR_API/v1/projects/$P/templates/n8n" \ -H "$H" -H "Content-Type: application/json" \ -H "Idempotency-Key: $NAME-n8n" -d '{}'{"template_id": "n8n", "version": 1, "project_id": "01j9zkk07fhzv5zsmn996cdwpb", "services": [{"id": "01j9zkff8y1dmcwa49fanx9qak", "name": "db", "kind": "database"}, {"id": "01j9zkwf4q15w38y0taf680jvv", "name": "web", "kind": "app"}], "deploy_started": true}O que o template cria
Seção intitulada “O que o template cria”| Serviço | Tipo | Detalhes |
|---|---|---|
db |
database, motor postgres |
cota de 1024 MB, só do n8n |
web |
app, público |
imagem n8nio/n8n fixada por digest, porta 5678, 1 GB de memória e 1 vCPU, healthcheck em /healthz, volume de 5 GB em /home/node/.n8n |
- Roda como
1000:1000, com tmpfs em/home/node/.cache. - Postgres próprio: o n8n guarda workflows, credenciais e execuções no
db. As variáveisDB_POSTGRESDB_*vêm por referência (${{db.PGHOST}}etc.) e a conexão usa TLS com verificação do certificado. - Chave de criptografia gerada:
N8N_ENCRYPTION_KEYé gerada por instância com{{generate:secret64}}(CSPRNG) e gravada como variável sensível. É ela que cifra as credenciais que você cadastra no n8n. - URL de webhook:
N8N_WEBHOOK_URLeN8N_EDITOR_BASE_URLapontam para a URL pública doweb(${{web.PUBLIC_URL}}), com HTTPS. Os webhooks que você criar já nascem com o endereço público correto. Se mudar o endereço do app, revise essas duas variáveis. - Também ficam definidos: fuso
America/Sao_Paulo, cookie seguro, um salto de proxy, e telemetria e avisos de versão desligados.
Primeiro acesso
Seção intitulada “Primeiro acesso”Abra a URL pública do web. O n8n pede para criar o usuário dono na primeira visita: faça isso logo após o deploy, antes de divulgar a URL.
Você precisa guardar três coisas. Sem a chave, o backup do banco não recupera as credenciais.
- Banco
db: peça um backup sob demanda (POST /v1/projects/{p}/databases/{s}/backups) e veja a política de backups diários em Backup e restore. Antes de atualizar a versão do n8n, faça um backup. - Chave
N8N_ENCRYPTION_KEY: copie o valor para um cofre seu. Ler variável sensível exige o escopoenv:reveale confirmação de identidade (Confirmação de identidade). Para restaurar em outro projeto, defina a mesma chave antes do primeiro start, ou as credenciais salvas ficam ilegíveis. - Volume
/home/node/.n8n: guarda arquivos locais do n8n. As definições de workflow ficam no banco, mas exporte também os seus workflows pelo próprio n8n (menu do workflow, Download) como cópia portátil.
Cada mudança de variável vira uma versão no Histórico de configuração; o restore reaplica os valores originais sem expô-los.