Como baixar e instalar o n8n no Windows, Mac e Linux?

Fala aí, beleza? O n8n é o mesmo software nos três sistemas: o que muda mesmo é o caminho até ele subir, e é aí que quase todo mundo trava

Este guia junta Windows, macOS e Linux num lugar só, com os quatro caminhos possíveis (npx, npm, Docker e o instalador de uma linha), o que cada um exige, e os erros específicos que aparecem em cada sistema na hora de instalar n8n

Bora ver na prática?

O que você precisa antes de baixar o n8n

Antes de sair rodando comando, vale separar por caminho, porque os requisitos são bem diferentes

Se você vai pelo npm ou npx: precisa de Node.js dentro de uma faixa específica, entre 20.19 e 24.x, inclusive

Versões anteriores a 20.19 simplesmente não iniciam o n8n

E por quê? O suporte ao Node.js 18 caiu depois do fim de vida dele, em abril de 2025, então aquele Node antigo parado na sua máquina desde o ano passado provavelmente não serve mais

Se você vai pelo Docker: precisa de Docker Engine e Docker Compose v2 (dá pra conferir com docker compose version), além de no mínimo 4 GB de RAM e 2 vCPUs

Esse mínimo é o que a documentação oficial pede, então se a sua máquina tá no limite, confere isso ANTES de começar o download da imagem

Formação Recomendada

Formação Agentes de IA

Domine a criação de Agentes de IA e Venda para Empresas

• 402 aulas
• 32 projetos
• 38h 19min

Conhecer formação

Duas coisas que ajudam a calibrar expectativa antes de começar:

• a versão do pacote publicada no npm no momento desta pesquisa era a 2.35.3, de 14 de agosto de 2026
• o n8n NÃO é open source no sentido OSI: ele usa a Sustainable Use License, uma licença fair-code adotada em março de 2022 no lugar da Apache 2.0 com Commons Clause

Na prática, o código é livre pra uso pessoal e interno, com restrições a usos comerciais (revender como serviço hospedado por terceiros, white-label ou produto concorrente), e os recursos Enterprise, marcados em arquivos e diretórios próprios, exigem licença Enterprise

Se você só quer rodar na sua máquina e automatizar suas coisas, tá tranquilo 🙂

npx, npm, Docker ou instalador de uma linha: qual escolher em cada sistema

Repara numa coisa importante da última linha: o instalador de uma linha exige Linux ou macOS com curl

No Windows, a abordagem recomendada pela documentação é rodar dentro do WSL

O Git Bash com Docker Desktop até consegue rodar scripts shell POSIX, mas a orientação pra esse comando é ficar no WSL mesmo

Todos esses métodos sobem o n8n na SUA máquina

Se o plano é deixar rodando sem depender do seu PC ligado, o assunto vira outro, tipo instalar o n8n na Vercel, e aí os requisitos mudam

Como instalar o n8n com npm ou npx (Windows, Mac e Linux)

Esse é o caminho mais curto pra quem já vive no terminal e só quer ver o n8n de pé

1. Confira a versão do Node.js, porque é aqui que a maioria se ferra

node -v

O número tem que estar entre 20.19 e 24.x, inclusive

O erro comum deste passo: Node abaixo de 20.19, que não inicia o n8n de jeito nenhum

2. Rode o n8n sem instalar nada, se a ideia é só testar

npx n8n

O npx baixa tudo o que é necessário e sobe o n8n na hora

3. Ou instale de forma global, se você pretende usar com frequência

npm install n8n -g

O erro comum deste passo aparece principalmente no macOS: erros de permissão em pastas globais protegidas pelo sistema, e aquele clássico command not found no zsh depois que o npm install n8n -g termina "com sucesso"

Nesses casos o Docker é apontado como saída, justamente pra não esbarrar nessas permissões

4. Abra a interface no navegador

http://localhost:5678

Se abriu a tela de configuração inicial, tá tudo certo 😀

Como instalar o n8n com Docker (o caminho recomendado)

Antes do comando, uma explicação rápida do PORQUÊ, que é o que faz diferença aqui

Com Docker, você não instala as dependências do n8n na sua máquina: elas já vêm dentro da imagem

A imagem é o conjunto de dependências, o contêiner é a aplicação de fato rodando, o volume é o que guarda os dados entre reinícios e a porta é por onde você acessa

Entendeu isso, você instala praticamente qualquer aplicação depois, não só o n8n

1. Crie o volume, que é onde os seus dados vão morar

docker volume create n8n_data

O erro comum deste passo é pular ele

Sem volume, workflows, credenciais e dados de execução vão embora quando o contêiner morre, e aí você refaz tudo do zero

2. Suba o contêiner com o comando oficial

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

Parece uma linha gigante e assustadora, mas cada pedaço faz uma coisa bem específica:

• GENERIC_TIMEZONE: define o fuso usado por nós baseados em agendamento, tipo o Schedule Trigger
• TZ: define o fuso do sistema, o que scripts e comandos como date retornam
• N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS: impõe permissões seguras no arquivo de configuração
• N8N_RUNNERS_ENABLED: liga os task runners, a forma recomendada de executar tarefas no n8n
• -v n8n_data:/home/node/.n8n: monta o volume no caminho fixo dentro do contêiner, onde ficam workflows, credenciais e dados de execução

Tome cuidado com o <SEU_FUSO>: é pra trocar pelo seu fuso de verdade, não deixar o <> ali

3. Acesse o editor

http://localhost:5678

O erro comum deste passo é conflito de porta: se você já tem outra aplicação ocupando a 5678, o contêiner não sobe direito

A porta é única, então ou você libera, ou escolhe outra

4. Se precisar trocar a porta, a variável N8N_PORT é a responsável por isso, e está na página de configuração básica do n8n auto-hospedado

Instalador de uma linha do n8n: quando usar e o que ele faz

Existe um instalador oficial que resolve tudo num comando só:

curl -fsSL https://get.n8n.io | sh

Antes de sair colando, os requisitos:

• sistema Linux ou macOS com curl instalado
• Docker e Docker Compose instalados E rodando (não adianta estar instalado e fechado)

E o que ele faz, na ordem: verifica o Docker, cria uma pasta chamada n8n no diretório atual e escreve os arquivos de configuração ali

Por isso vale rodar de dentro da pasta onde você quer que o n8n viva, e não em qualquer lugar do disco

A limitação importante: ele é voltado pra instalação NOVA

Não é a ferramenta certa pra alterar um setup que já existe, então se você já tem n8n rodando, esse não é o caminho

No Windows, como falei lá em cima, a orientação é rodar dentro do WSL

E se você prefere montar sua própria configuração em vez de usar o script, a documentação aponta o repositório n8n-hosting, com configurações de Docker Compose para diferentes arquiteturas

Como foi na prática: instalação local com Docker

No vídeo em que eu instalo o n8n self-hosted, o caminho foi exatamente esse: Docker Desktop, imagem, volume, porta, e pronto

Alguns números da minha máquina pra você calibrar expectativa de tempo e de espaço

A imagem que eu baixei tinha cerca de 1 GB, então não é aquele download instantâneo: dá pra levantar e tomar um café ☕

A porta que eu usei foi a 5678, e o destino do volume dentro do contêiner foi /home/node/.n8n

Esse caminho interno depende de cada imagem, então quando você for instalar outra coisa, consulta a documentação da imagem antes de subir, senão o dado não persiste onde você acha que persiste

Do lado do disco, eu criei manualmente uma pasta na unidade D pra servir de volume, com o nome n8n_data

Prefiro criar em um nível alto do sistema de arquivos, e não enterrada em cinco subpastas, porque depois você lembra onde estão os seus dados

Outro detalhe que economiza dor de cabeça: eu nomeei o contêiner na mão

Sem isso, o Docker gera um nome aleatório, e quando você tiver vários contêineres rodando, boa sorte pra achar qual é o do n8n haha

A versão que apareceu na minha instalação foi a 1.123

E isso é normal: quem instala não escolhe a versão, ela vem da imagem, então a sua vai ser diferente da minha

Depois do run, eu acompanhei o log do contêiner até ele avisar que o editor estava acessível, e abri pelo link da própria aba de contêineres

Se você não se sente à vontade com terminal, esse atalho pela interface do Docker Desktop resolve

O n8n abriu na tela de configuração inicial, igual a qualquer instalação nova, e eu criei um workflow do zero com um trigger só pra provar que estava funcionando

Erros de instalação do n8n no Windows e como resolver

No Windows, a maior parte dos problemas nem é do n8n: é do Docker Desktop travando antes de você começar

Docker Desktop reclama do WSL 2

Sintoma: erro de WSL 2, com kernel desatualizado ou ausente, e o Docker Desktop não sobe

Solução: abra o PowerShell como administrador e rode

wsl --update
wsl --install

Virtualização desativada na máquina

Sintoma: o Docker Desktop não inicia mesmo com o WSL atualizado

Causa: virtualização desligada no hardware

Solução: habilitar a virtualização no BIOS e ligar, nos Recursos do Windows, o "Subsistema do Windows para Linux" e a "Plataforma de Máquina Virtual"

Como prevenir: confira WSL e virtualização ANTES de instalar o Docker Desktop

É chato ter que reiniciar a máquina duas vezes no meio do tutorial, acredite 😛

Erros no macOS, no Linux e ao abrir o n8n pela rede

macOS: permissão e command not found

Sintoma: o npm install n8n -g dá erro de permissão, ou termina e o comando n8n some no zsh com command not found

Causa: pastas globais protegidas pelo sistema

Solução: o Docker é a saída apontada pra esse caso, justamente porque você não mexe nas pastas globais do sistema

Acessou por IP na rede local e caiu no aviso de cookie

Sintoma: aparece a mensagem "Your n8n server is configured to use a secure cookie, however you are visiting this via an insecure URL"

Causa: você acessou por IP da rede local em vez de localhost, sem HTTPS

Solução de contorno: a variável N8N_SECURE_COOKIE=false é usada nesse caso, mas ela é relatada como apropriada só pra desenvolvimento local

A orientação da comunidade é outra: configurar domínio e HTTPS de verdade quando a instalação for ficar exposta

Como prevenir: use localhost enquanto está testando, e quando for expor pra valer, vá pelo caminho de rodar o n8n no Google Cloud com domínio e certificado, em vez de desligar a proteção

n8n 3.0: por que instalar por npm tem prazo de validade

Essa parte muda a sua decisão hoje, então vale ler com atenção

A partir da versão 3.0, prevista para outubro de 2026, o n8n auto-hospedado só será distribuído via Docker

Ou seja: instalações via npm e npx n8n não serão mais suportadas

A recomendação é migrar pra Docker ANTES de atualizar, e o Docker Compose é apontado como o caminho mais fácil pra instalações locais

Traduzindo pro seu dia a dia: se é um teste de uma tarde, npx n8n resolve numa boa

Se é uma instalação que você quer manter rodando pelos próximos meses, começar por Docker agora te poupa uma migração depois

E pra quem chegou aqui procurando um instalador de desktop, aquele next, next e finish: o n8n Desktop App foi descontinuado

O encerramento foi anunciado junto com o fim do plano Team auto-hospedado, e o repositório n8n-io/n8n-desktop-app segue público apenas com as releases antigas

Então não perca tempo procurando o .exe oficial, ele não é mais o caminho

Conclusão

Resumindo a escolha, sem enrolação

Quer só ver o n8n funcionando hoje? npx n8n, com Node entre 20.19 e 24.x

Quer uma instalação que você vai manter e que não vai quebrar na próxima major? Docker, com o volume n8n_data criado antes de subir o contêiner

Tá no Linux ou no macOS, já tem Docker rodando e quer tudo pronto de uma vez? O instalador de uma linha faz o trabalho

O próximo passo é o mesmo em qualquer sistema: sobe o n8n, abre http://localhost:5678 e cria o primeiro workflow com um trigger só pra sentir a ferramenta na mão

Depois disso a brincadeira começa de verdade…

Até o próximo post!