Como instalar o n8n: Cloud, Docker ou npm

Três formas de executar o n8n

Opção	Tempo de instalação	Custo	Ideal para
n8n Cloud	2 minutos	A partir de 20 €/mês	Equipas não técnicas, início rápido
Docker	10–30 minutos	Gratuito + servidor	Alojamento próprio em produção
npm / npx	5 minutos	Gratuito	Experimentar o n8n no seu portátil

Opção 1: n8n Cloud

1. Aceda a n8n.io e inicie um período de avaliação gratuito.
2. Escolha um nome para o espaço de trabalho. Recebe um URL como yourname.app.n8n.cloud.
3. Comece a criar. Atualizações, cópias de segurança e SSL são tratados por si.

Escolha o Cloud se ninguém na sua equipa quiser manter um servidor. Paga por execução (2500 no plano Starter), por isso verifique primeiro o seu volume.

Opção 2: Docker (recomendado para alojamento próprio)

O Docker executa o n8n num contentor isolado, o que facilita atualizá-lo e mudá-lo de sítio. Instale o Docker Desktop no seu computador ou o Docker Engine num servidor Linux e execute:

docker volume create n8n_data

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -e GENERIC_TIMEZONE="Europe/Budapest" \
  -e TZ="Europe/Budapest" \
  -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
  -e N8N_RUNNERS_ENABLED=true \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

Abra http://localhost:5678 e crie a conta de proprietário.

O que faz cada parte:

• O volume n8n_data mantém os seus workflows e credenciais quando o contentor reinicia. Sem ele, perde tudo ao reiniciar.
• -p 5678:5678 expõe o editor do n8n na porta 5678.
• GENERIC_TIMEZONE faz com que os nós Schedule Trigger corram na sua hora local.

Para um servidor a sério, o n8n recomenda Docker Compose com PostgreSQL e um proxy inverso para HTTPS. Explicamos essa configuração em alojar o n8n num VPS.

Opção 3: npm ou npx (teste local rápido)

O n8n precisa do Node.js 20.19 a 24.x. Verifique a sua versão com node -v.

Experimente sem instalar:

npx n8n

Ou instale globalmente:

npm install n8n -g
n8n start

Depois abra http://localhost:5678.

O npm é ótimo para aprender e testar. Para tudo aquilo de que outras pessoas dependem, use o Docker, porque as atualizações e cópias de segurança são mais simples e evita conflitos de versões do Node.

Webhooks numa instalação local

Apps como o Stripe ou o Typeform precisam de um URL público para enviar dados para os seus nós Webhook. Num portátil, localhost não é acessível a partir da Internet. Opções:

• Use um túnel como o Cloudflare Tunnel (cloudflared) para testes.
• Faça a implementação num VPS com domínio para qualquer uso real.

Atualizar o n8n

• Cloud: automático.
• Docker: docker pull docker.n8n.io/n8nio/n8n e depois recrie o contentor. Os seus dados ficam no volume.
• npm: npm update -g n8n.

Faça primeiro uma cópia de segurança. Leia as notas de versão para identificar alterações incompatíveis antes de atualizações importantes.

Que opção escolher?

• Só quer explorar: npx.
• Executa workflows de negócio reais e alguém pode gerir um servidor: Docker num VPS.
• Não há ninguém com perfil técnico disponível: n8n Cloud.

Próximos passos

• Alojar o n8n num VPS por menos de 10 $ por mês
• Ligar credenciais do Google, Slack e OAuth