Ir para o conteúdo
Promovaweb

Suba o n8n com o script de instalação oficial

Revisado em

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:

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

O 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.