Suba o n8n com o script de instalação oficial
Antes de começar
Deixar uma instância do n8n rodando em http://localhost:5678 no seu computador.
- Docker instalado e rodando, com o plugin docker compose v2.
- Terminal com acesso à internet.
O n8n mantém um script que prepara tudo com um comando. Ele substitui a antiga instalação por npm e npx n8n, que deixa de existir no n8n 3.0. O script usa Docker, então instale o Docker antes de seguir.
Rode o comando
Abra o terminal na pasta escolhida para guardar a instância e rode:
curl -fsSL https://get.n8n.io | shO script confere se o Docker está instalado e rodando, cria a pasta n8n, grava os arquivos de configuração com segredos próprios e sobe o n8n. A primeira execução baixa as imagens e pode levar alguns minutos.
Ao final, o terminal mostra o endereço da instância e os comandos do dia a dia. Rodar o script de novo na mesma pasta não altera nada. Ele só avisa que a instância já existe.
O que fica na pasta
| Arquivo | Para que serve |
|---|---|
n8n/compose.yml |
Define os containers da instância |
n8n/.env |
Guarda a versão e os segredos gerados na instalação |
Os workflows, as credenciais e o histórico ficam em um volume do Docker, no banco SQLite embutido. Para estudar, esse banco atende. A stack de estudos com Postgres e Traefik está no guia de Docker Compose.
Comandos do dia a dia
| Para | Rode |
|---|---|
| Parar | docker compose -f ./n8n/compose.yml down |
| Subir de novo | docker compose -f ./n8n/compose.yml up -d |
| Atualizar | curl -fsSL https://get.n8n.io | sh -s -- --upgrade |
O comando de remoção com down -v apaga workflows, credenciais e histórico da instância. Exporte seus workflows antes de usar.
Cadastre o usuário owner
Abra http://localhost:5678 no navegador. Na primeira visita, o n8n solicita nome, e-mail e senha do usuário owner, o administrador da instância. Guarde essa senha. A recuperação exige a CLI.
Confira o resultado
O endereço http://localhost:5678 abre a tela de cadastro do usuário owner do n8n.
Fontes e conferência
Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.
