O n8n é distribuído sob a Sustainable Use License: uso interno de negócios ou pessoal. Leia a licença antes de oferecer o n8n a terceiros. Este template é um empacotamento da Vertra Cloud e não é afiliado ao n8n.
Requisitos e plano
O primeiro boot leva de 25 a 60 segundos, porque o n8n cria o próprio banco de dados.
Escolha como o n8n roda
O assistente pergunta How will n8n run? A escolha define o que é criado e quanta memória é usada.
O Postgres é o padrão seguro: lida melhor com concorrência que o SQLite e mantém o histórico fora do disco do app.
No modo com workers aparece uma segunda pergunta, Parallel executions on the worker (5 por padrão). Mais paralelismo exige mais memória no worker.
Crie o n8n
1
Abra o template
No dashboard, abra Templates, escolha n8n e clique em Use template. Na CLI:
vertra template deploy n8n --name my-n8n --set mode=postgres.2
Responda ao assistente
Escolha o modo, o time zone for schedules (America/Sao_Paulo, UTC, America/New_York ou Europe/Lisbon) e os modules allowed in the Code node. Safe (padrão) permite apenas módulos de dados e texto; All permite também arquivos, processos e rede dentro do seu próprio container.Opcionalmente, ative já o e-mail (SMTP): veja E-mail para convites.
3
Dê um nome e crie
Dê um nome ao app, escolha o workspace e a pasta e clique em Create. Quando terminar, você recebe o endereço do app e o próximo passo. O n8n gera os próprios segredos; você não digita nenhum.
Primeiro acesso: crie o dono
A partir daí, cada pessoa que precisar de acesso é convidada em Settings > Users.Seu primeiro fluxo com um webhook
1
Crie o fluxo
Clique em Create workflow e adicione um nó Webhook. Defina o método (por exemplo
POST) e um caminho.2
Adicione um nó Code
Adicione um nó Code depois do webhook e escolha a linguagem (próxima seção).
3
Teste e depois ative
A Test URL funciona enquanto você escuta um evento de teste no editor. Para receber chamadas reais, ative o fluxo: a Production URL só responde enquanto o fluxo está ativo.
URLs de webhook
O n8n monta os endereços de webhook a partir do endereço público do app: a URL de produção é<address>/webhook/<path> e a de teste, <address>/webhook-test/<path>. Copie sempre a URL do nó Webhook em vez de digitá-la. Se o nó mostrar um endereço que você não reconhece, abra as variáveis do app e confira se N8N_WEBHOOK_URL é o endereço mostrado nas saídas.
Os webhooks são atendidos pelo editor, em todos os modos. As chamadas vindas da internet chegam ao n8n por HTTPS; o corpo da requisição pode ter até 16 MiB.
Código em JavaScript e Python
O nó Code roda em qualquer das duas linguagens, no mesmo container, sem serviço extra.O que você pode importar
Com módulos Safe (o padrão), só módulos de dados e texto são permitidos:- Python:
json,re,datetime,math,random,statistics,collections,itertools,functools,string,time,uuid,base64,hashlib,hmac,decimal,fractions,textwrap,csv,io,copy,typing,html,zoneinfo,calendar,operator,bisect,heapq,secrets. - JavaScript:
crypto,url,path,util,zlib,buffer,querystring,string_decoder,events,stream,assertemoment.
Import of standard library module ... is disallowed. Para permitir tudo, mude VERTRA_CODE_MODULES para all nas variáveis do app e reinicie. All também deixa o código tocar arquivos, processos e a rede do seu próprio container, então escolha-o apenas quando confiar em todos os fluxos que rodam ali.
Nós da comunidade
Abra Settings > Community nodes > Install e informe o nome do pacote npm. Os nós instalados ficam em/app/.n8n/nodes e sobrevivem a reinícios e atualizações; no modo com workers, o worker os reinstala quando inicia. A instalação exige que o app alcance o registry do npm.
E-mail para convites e redefinição de senha
Sem SMTP, o n8n não consegue enviar convites nem e-mails de redefinição. No assistente, responda Yes, use my SMTP server e preencha:
Com o SMTP configurado, Settings > Users > Invite envia o convite por e-mail. O nó Send Email não usa essa configuração: ele tem a própria credencial em cada fluxo.
Credenciais e a chave de criptografia
O n8n guarda as credenciais dos seus fluxos (chaves de API, tokens OAuth) criptografadas com uma chave. O template a gera uma vez e a mantém nas variáveis do app comoN8N_ENCRYPTION_KEY; o editor e o worker usam a mesma.
Backups, atualizações e rollback
- Backups. Os dados ficam no banco de dados Postgres (ou em
/app/.n8ncom SQLite) e nos arquivos em/app/.n8n. Use snapshots do app e do banco de dados. Para uma cópia portátil dos seus fluxos, exporte-os também pelo n8n. - Atualizações. As novas versões do n8n chegam como novas versões do template. Você vê New version available e clica em Update; antes, é feito um snapshot de segurança.
- Rollback. O n8n migra o próprio banco de dados ao atualizar, então voltar sempre devolve os dados também: restaure o snapshot de segurança feito antes da atualização. O rollback só do código é bloqueado por esse motivo.
- O histórico de execuções é apagado após 7 dias ou 5.000 execuções, o que vier primeiro.
Limites que você precisa conhecer
- O modo com workers cria um worker. O worker não tem endereço público e fala apenas com o Postgres e o Redis.
- Não há processadores de webhook dedicados: o editor atende os webhooks.
- O deploy sem downtime está desligado e não pode ser ligado: duas cópias do n8n em modo fila agiriam ambas como líder e os gatilhos por polling rodariam duas vezes. Mantenha uma única cópia do app.
- O uso de memória do editor é de cerca de 300 a 540 MiB; o do worker, de 330 a 560 MiB.
- Os nós Execute Command e Local File Trigger vêm desativados pelo n8n. O
ffmpegnão está na imagem.
Problemas comuns
Import of standard library module ... is disallowed
Import of standard library module ... is disallowed
O módulo não está na lista segura. Mude
VERTRA_CODE_MODULES para all e reinicie, ou evite esse módulo.A primeira chamada do Code é lenta
A primeira chamada do Code é lenta
Normal: o executor inicia sob demanda e para após 15 segundos ocioso. As chamadas seguintes são rápidas.
O app nunca termina de iniciar
O app nunca termina de iniciar
Confira se
N8N_ENCRYPTION_KEY nas variáveis do app é a chave que o n8n guardou na primeira vez. Uma chave diferente interrompe o boot.Um nó da comunidade não instala
Um nó da comunidade não instala
O app não tem acesso de saída ao registry do npm, ou não sobrou espaço em
/app. Verifique o log do app e o disco.Outra pessoa criou a conta de dono
Outra pessoa criou a conta de dono
Outra pessoa abriu o endereço antes de você. Apague o app, crie-o de novo e abra o endereço assim que o deploy terminar.
Relacionados
n8n no catálogo
O que o template cria e suas variáveis.
Atualizar e fazer rollback
O snapshot de segurança e o rollback com dados.
Página pública
O template na galeria pública.
Stacks
Como o app, o Postgres e o Redis convivem.