# 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](/guia/templates/), com o id `n8n` e sem parâmetros.

```bash
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 '{}'
```
```json
{"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

| 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áveis `DB_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_URL` e `N8N_EDITOR_BASE_URL` apontam para a URL pública do `web` (`${{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

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.

## Backup

Você precisa guardar **três coisas**. Sem a chave, o backup do banco não recupera as credenciais.

1. **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](/bancos/backup-restore/). Antes de atualizar a versão do n8n, faça um backup.
2. **Chave `N8N_ENCRYPTION_KEY`:** copie o valor para um cofre seu. Ler variável sensível exige o escopo `env:reveal` e confirmação de identidade ([Confirmação de identidade](/seguranca/confirmacao-de-identidade/)). Para restaurar em outro projeto, defina a mesma chave antes do primeiro start, ou as credenciais salvas ficam ilegíveis.
3. **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](/operacao/historico-de-configuracao/); o restore reaplica os valores originais sem expô-los.
