Como publicar o n8n na Zenifra

O n8n pode ser publicado na Zenifra como um projeto HTTP a partir da imagem oficial. Este guia mostra a configuração recomendada, as variáveis necessárias e como validar o resultado.

Pré-requisitos

Conta verificada e acesso ao console.
Permissão para criar projetos na organização (project.create).
Crédito ou cartão cadastrado para o plano escolhido; veja Modelos de pagamento.

O n8n está no catálogo público de Templates. Use Implantar para criar a aplicação com a configuração recomendada, ou Personalizar para revisar plano, armazenamento e variáveis e, se quiser, criar um banco de dados junto antes de confirmar. Os passos abaixo mostram uma configuração manual a partir da imagem oficial.

Passo 1: criar o projeto HTTP

No console, clique em + Criar Projeto, escolha HTTP e preencha:

Campo	Valor
Origem do projeto	Imagem Docker
Imagem	`docker.io/n8nio/n8n:2.5.2`
Registry	Público, sem autenticação
Plano	Premium (1 vCPU e 1 GB de RAM) atende a maioria dos workflows. Para alto volume de execuções, use Premium Plus ou superior.
Porta	`5678`
Instâncias	1. O editor do n8n não deve rodar em várias instâncias sem uma configuração de fila dedicada.
Armazenamento persistente	Sim, 5 GB, diretório `/home/node/.n8n`

Escolha um nome entre 6 e 32 caracteres, com letras minúsculas, números e hífens; ele também define o endereço *.clients.zenifra.com. Para testes, o modelo por hora é o mais barato; para uso contínuo, compare com o mensal.

Armazenamento

Obrigatório. Workflows, credenciais e histórico de execuções ficam nesse diretório; sem ele, tudo é perdido ao reiniciar.

Passo 2: configurar variáveis de ambiente

Cadastre as variáveis abaixo no passo Variáveis de ambiente:

N8N_HOST=<seu-endereco>.clients.zenifra.com
N8N_PORT=5678
N8N_PROTOCOL=https
WEBHOOK_URL=https://<seu-endereco>.clients.zenifra.com/
N8N_ENCRYPTION_KEY=<chave-aleatoria-longa>
GENERIC_TIMEZONE=America/Sao_Paulo

Guarde a N8N_ENCRYPTION_KEY: ela criptografa as credenciais salvas e precisa ser a mesma em todas as versões. Se usar domínio próprio, troque o endereço em N8N_HOST e WEBHOOK_URL. Veja Variáveis de ambiente.

Passo 3: criar e validar

Revise o custo estimado e clique em Criar Projeto. Ao final, o console abre a página do projeto com o endereço público.

Abra a URL do projeto. No primeiro acesso, o n8n pede a criação da conta de proprietário: crie-a imediatamente, antes de compartilhar o endereço. Depois, crie um workflow com um nó Webhook e confirme que a URL exibida usa o endereço configurado em WEBHOOK_URL.

Se a aplicação não responder, confira os logs do projeto, a porta configurada e o guia de solução de problemas.

Recomendações para produção

Use o modelo mensal para automações que rodam 24/7.
Para muitos workflows, conecte o n8n a um PostgreSQL gerenciado em vez do banco local padrão.
Restrinja o editor por IP com controle de acesso quando o plano permitir.

Para remover o projeto, abra-o em Projetos e clique em Excluir. A exclusão é permanente e apaga o armazenamento.