Instalar o n8n com Docker é o caminho mais rápido para ter uma instância própria rodando, e leva poucos minutos com os comandos certos. Este guia cobre a instalação básica, para testar e aprender — a versão de produção, com HTTPS e mais robustez, é o assunto da próxima aula.

Adicione ao Google Notícias
Neste artigo
  1. Pré-requisitos
  2. Instalação rápida, com um comando
  3. Adicionando autenticação básica
  4. Rodando em segundo plano
  5. Perguntas frequentes

Pré-requisitos

  • Docker instalado no seu computador ou servidor.

  • Acesso ao terminal.

Instalação rápida, com um comando

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

Isso baixa a imagem oficial e sobe o n8n na porta 5678. Acesse http://localhost:5678 no navegador para abrir a interface.

O -v n8n_data:/home/node/.n8n é essencial: ele cria um volume que guarda seus dados fora do contêiner. Sem isso, toda vez que o contêiner for recriado, seus fluxos e credenciais somem.

Adicionando autenticação básica

Por padrão, a instância fica sem senha nenhuma — qualquer um com acesso ao endereço entra. Para adicionar proteção mínima:

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -e N8N_BASIC_AUTH_ACTIVE=true \
  -e N8N_BASIC_AUTH_USER=seu_usuario \
  -e N8N_BASIC_AUTH_PASSWORD=sua_senha_forte \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

Rodando em segundo plano

O comando acima roda "preso" ao terminal — fechar a janela derruba o n8n. Para rodar em segundo plano, de verdade:

docker run -d \
  --name n8n \
  --restart unless-stopped \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

O -d roda desacoplado, e --restart unless-stopped faz o contêiner reiniciar sozinho se o servidor reiniciar ou o processo cair.

Essa instalação é adequada para testar e aprender. Para produção — acessível pela internet, com dado real de cliente —, faltam peças essenciais: HTTPS, domínio próprio, banco de dados robusto. A próxima aula cobre exatamente essa versão completa.

Um comando Docker sobe o n8n localmente em minutos. Adicione autenticação básica, use volume para persistir dados, e rode em segundo plano com restart automático.

Perguntas frequentes

Como instalar o n8n com Docker?

Com o comando docker run apontando para a imagem oficial docker.n8n.io/n8nio/n8n, mapeando a porta 5678 e um volume para persistir os dados fora do contêiner.

Por que preciso do volume ao instalar com Docker?

Sem o volume, os dados ficam apenas dentro do contêiner. Se ele for recriado ou removido, todos os fluxos e credenciais são perdidos — o volume garante que os dados sobrevivam independentemente do contêiner.

Essa instalação já serve para produção?

Não completamente. Falta HTTPS, domínio próprio e um banco de dados mais robusto que o padrão. Serve bem para testar e aprender; a versão de produção é tratada na aula seguinte.