Instalação via npm

npm é uma das formas mais rápidas de iniciar o n8n no seu computador local. Você precisa ter o Node.js instalado. O n8n requer uma versão do Node.js entre 20.19 e 24.x, inclusive.

Versões estável e beta

O n8n lança quase toda semana uma nova versão menor. A versão stable é adequada para ambientes de produção, enquanto a versão beta corresponde à versão mais recente lançada, podendo não ser totalmente estável. Caso encontre problemas, utilize o fórum da comunidade para relatar.

Versão stable atual: 2.10.2
Versão beta atual: 2.11.1

Testando o n8n com npx

Você pode testar o n8n sem precisar instalá-lo, usando o npx.

Execute o seguinte comando no terminal:

npx n8n

Esse comando baixará tudo o que for necessário para iniciar o n8n. Após a conclusão, abra o navegador em http://localhost:5678 para acessar o n8n e começar a criar seus fluxos de trabalho.

Instalação global do n8n (usando npm)

Instale o n8n globalmente com o npm:

npm install n8n -g

Use a sintaxe com @ para instalar ou atualizar para uma versão específica do n8n. Por exemplo:

npm install -g [email protected]

Para instalar a versão next:

npm install -g n8n@next

Após a instalação, inicie o n8n com um dos comandos abaixo:

n8n
# ou
n8n start

Próximos passos

Explore os recursos do n8n com o guia de início rápido.

Atualização

Atualize sua instância do n8n para a versão latest:

npm update -g n8n

Para instalar a versão next:

npm install -g n8n@next

Usando o túnel (Tunnel) do n8n

Perigo
Use apenas para desenvolvimento e testes locais. Não é adequado para ambientes de produção.

Ferramenta de desenvolvimento

A funcionalidade de túnel é uma ferramenta conveniente para desenvolvimento local. Sua implementação interna pode mudar conforme novas versões do n8n forem lançadas.

Para usar nós gatilho com webhooks de serviços externos (como o GitHub), o n8n precisa ser acessível pela internet. O n8n oferece um serviço de túnel baseado no cloudflared, que redireciona requisições da internet para sua instância local do n8n. Esse recurso exige o Docker.

É necessário instalar o Docker
O túnel usa o cloudflared, que é executado como um contêiner Docker. Mesmo que você esteja executando o n8n via npm, é necessário ter o Docker instalado na sua máquina.

Para instalações via npm, use o modo somente serviço: inicie o cloudflared como um serviço independente e execute o n8n localmente:

# Terminal 1: Inicia o serviço de túnel cloudflared
pnpm --filter n8n-containers services --services cloudflared

# Terminal 2: Inicia o n8n localmente
pnpm dev

O comando services inicia o cloudflared, obtém uma URL pública de túnel e grava um arquivo .env em packages/cli/bin/.env com as variáveis WEBHOOK_URL e N8N_PROXY_HOPS=1. O n8n lê automaticamente esse arquivo .env ao iniciar.

Para limpar os recursos após o uso:

pnpm --filter n8n-containers services:clean

Para o modo de pilha completa (com n8n e cloudflared ambos rodando em contêineres), consulte a configuração de túnel com Docker.

Reverter uma atualização

Instale a versão anterior à qual deseja retornar.

Se a atualização envolveu migrações de banco de dados:

1. Consulte a documentação de funcionalidades e as notas de lançamento para verificar se há alterações manuais necessárias.
2. Execute n8n db:revert na versão atual para reverter a última migração do banco de dados. Se for necessário reverter várias migrações, repita esse comando quantas vezes forem necessárias.

Solução de problemas no Windows

Se você encontrar problemas ao executar o n8n no Windows, certifique-se de que seu ambiente Node.js está configurado corretamente. Consulte o guia da Microsoft sobre como instalar o Node.js no Windows.