Pular para o conteúdo
LabS Atlas
Agentic AI
Entrar

Instalação Local do N8N com Docker

Ir para notas que citam esta
atualizado há 25 diasEntre para perguntar ao Labinho sobre esta notaO Labinho é o assistente que responde com as notas e as sessões do LabS e mostra de onde tirou cada resposta.

Instalação local do N8N com Docker é o caminho de subir a plataforma e os serviços de apoio na própria máquina, em contêineres, a partir de um repositório com um arquivo de composição pronto — em vez de usar a versão hospedada.

A vantagem é dupla. Nada do que passa pelos fluxos sai da máquina, o que importa quando os documentos usados em uma base de conhecimento são internos. E a versão autogerenciada não impõe as cotas do plano hospedado, o que permite testar à vontade enquanto se aprende. A contrapartida é que alguns recursos ficam de fora: variáveis personalizadas, por exemplo, não aparecem na versão gratuita usada localmente.

O que sobe junto e por quê

O arquivo de composição não levanta apenas a plataforma de automação. Ele sobe também um banco relacional, que é onde o próprio N8N persiste workflows, credenciais e histórico de execuções, e um banco vetorial, necessário assim que o assunto vira RAG — no caso, o Qdrant, que ainda expõe um painel próprio acessível localmente. Um banco de documentos pode aparecer na mesma subida mesmo sem uso imediato, reservado para etapas posteriores.

Antes de levantar os contêineres é preciso criar uma rede Docker dedicada. Sem ela, os serviços sobem isolados e não conseguem se enxergar: a automação não acha o banco, o nó de busca vetorial não acha a coleção. É o passo mais fácil de pular e o que mais gera erro difícil de diagnosticar depois.

Tropeços comuns

  • Colisão de nome. Quem já tem uma rede ou um contêiner com o mesmo nome do arquivo de composição recebe erro na subida. A saída é renomear a rede ou o serviço antes de executar, não apagar o que já existia.
  • Falha no contêiner do banco relacional ao final da instalação. Costuma vir de um arquivo de variáveis de ambiente que deveria acompanhar o repositório e não foi encontrado.
  • Autenticação ao clonar. Login de rede corporativa não funciona como credencial do repositório, e sem token ou chave configurada o clone por HTTPS falha. Baixar o projeto como arquivo compactado e extrair na pasta de trabalho resolve sem perder nada.
  • Cadastro na primeira abertura. A plataforma pede usuário e senha só para uso local. Senha esquecida se recupera por comandos do Docker, sem perder os fluxos salvos. Na primeira execução a tela inicial aparece como se fosse criar um workflow novo; a listagem completa só surge depois do primeiro salvamento.

Quando não instalar localmente

Quem já mantém uma infraestrutura própria rodando contêineres — um servidor doméstico com gerenciador de contêineres e proxy reverso na frente — pode usar a mesma pilha ali, sem repetir a instalação na máquina pessoal. O único requisito é conseguir acompanhar o que está sendo construído, já que os nomes de serviço e os endereços mudam.

O que precisa sobreviver a um

docker compose down Fluxos, credenciais e histórico de execução moram no banco relacional, e a coleção vetorial mora no banco de vetores. Se esses dois não estiverem em volumes persistentes, derrubar a pilha apaga todo o trabalho. Expor essa instância local para fora da máquina é outro assunto, tratado em Exposição de N8N Local com Túnel Cloudflare.