Resumo Rápido: Executar o n8n localmente requer npm (Node.js 20.19-24.x) ou Docker. O método mais rápido utiliza npx n8n para testes imediatos sem instalação, enquanto o Docker oferece melhor isolamento e prontidão para produção. Ambos os métodos proporcionam acesso total às capacidades de automação de fluxo de trabalho do n8n sem custos recorrentes de nuvem.
Configurar o n8n em uma máquina local elimina taxas de assinatura recorrentes, ao mesmo tempo que proporciona controle completo sobre a automação do fluxo de trabalho. De acordo com a documentação oficial do n8n, a plataforma requer a versão do Node.js entre 20.19 e 24.x para instalações npm, ou Docker para implantações em contêineres.
A decisão entre hospedagem local e serviços em nuvem impacta tanto o orçamento quanto a flexibilidade. De acordo com discussões da comunidade, instalações locais lidam com fluxos de trabalho ilimitados, enquanto os planos de nuvem incluem preços baseados em execução (a partir de US$ 24/mês por 2.500 execuções, de acordo com alguns relatos de usuários).
Pré-requisitos para Instalação Local
Antes de instalar o n8n localmente, o sistema precisa de software específico, dependendo do método escolhido.
A versão necessária do Node.js para uma instalação npm depende inteiramente dos requisitos específicos da versão do n8n que você está implantando, pois o próprio npm é compatível com todas as versões LTS do Node.js atualmente suportadas. A documentação oficial especifica essa faixa de versão exata para compatibilidade. Verifique a versão atual executando node –version no terminal.
As instalações Docker requerem Docker Engine ou Docker Desktop. A equipe do n8n recomenda o Docker para a maioria das necessidades de auto-hospedagem, pois ele fornece isolamento limpo e evita incompatibilidades com o sistema operacional.
Requisitos do Sistema
Instâncias n8n locais rodam em sistemas Windows, macOS e Linux. Nenhuma especificação mínima de RAM aparece na documentação oficial, mas a complexidade do fluxo de trabalho determina as necessidades reais de recursos.
A instalação consome espaço em disco mínimo inicialmente. Os requisitos de armazenamento crescem com base nos dados do fluxo de trabalho, histórico de execução e pacotes de nós personalizados.
Método 1: Executando n8n com npm
A instalação npm fornece o caminho mais rápido para executar o n8n localmente. Este método funciona diretamente no sistema host sem contêinerização.
Início Rápido com npx
A abordagem mais simples usa npx sem instalação permanente. Abra um terminal e execute:
| npx n8n |
Este comando baixa tudo o que é necessário e inicia o n8n automaticamente. A interface se torna acessível em localhost:5678 em segundos.
O método npx funciona perfeitamente para testes e avaliação. Ele não requer pacotes npm globais ou alterações permanentes no sistema.
Instalação Global npm
Para instalação permanente, o pacote npm global oferece acesso consistente:
| npm install n8n -g |
Após a conclusão da instalação, inicie o n8n a qualquer momento executando:
| n8n |
A versão estável principal atual do n8n é 2.x (por exemplo, 2.10.4). Versões beta podem conter recursos instáveis e devem ser evitadas para fluxos de trabalho de produção.
Configuração e Armazenamento de Dados
As instalações npm armazenam os dados do fluxo de trabalho no diretório ~/.n8n por padrão. Este local contém credenciais, definições de fluxo de trabalho e histórico de execução.
Variáveis de ambiente controlam o comportamento do n8n. Defina a variável N8N_PORT para alterar a porta padrão 5678. Outras variáveis configuram conexões de banco de dados, URLs de webhook e configurações de autenticação.
Método 2: Executando n8n com Docker
A instalação Docker representa a abordagem recomendada para hospedagem local do n8n. A documentação oficial enfatiza o Docker para necessidades de auto-hospedagem de produção.
Comando Básico Docker Run
Inicie o n8n com um único comando Docker:
| docker run -it –rm –name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n |
Este comando cria um contêiner chamado n8n, mapeia a porta 5678 para o host e persiste dados no diretório ~/.n8n.
O contêiner é executado interativamente com o sinalizador -it. Remova –rm para manter o contêiner após pará-lo.
Docker Compose para Configuração de Produção
Configurações do Docker Compose oferecem melhor controle para ambientes de produção. O repositório n8n-hosting no GitHub contém arquivos Docker Compose prontos para uso para várias arquiteturas.
Uma configuração básica do docker-compose.yml se parece com isto:
| version: ‘3.8’ services: n8n: image: n8nio/n8n restart: always ports: – “5678:5678” environment: – N8N_BASIC_AUTH_ACTIVE=true – N8N_BASIC_AUTH_USER=admin – N8N_BASIC_AUTH_PASSWORD=password volumes: – ~/.n8n:/home/node/.n8n |
Inicie o stack com:
| docker-compose up -d |
O sinalizador -d executa os contêineres em modo detached, permitindo o uso do terminal para outras tarefas.
Configuração Inicial e Acesso
Após iniciar o n8n por qualquer um dos métodos, navegue até localhost:5678 em um navegador web. A tela de configuração inicial solicita um endereço de e-mail e senha para a conta de administrador.
Este primeiro usuário se torna o proprietário da instância com privilégios administrativos completos. Usuários adicionais podem ser adicionados posteriormente através da interface de gerenciamento de usuários.
Configuração de Autenticação
Por segurança, habilite a autenticação mesmo em instalações locais. Configurações do Docker Compose aceitam variáveis de ambiente de autenticação diretamente:
| N8N_BASIC_AUTH_ACTIVE=true N8N_BASIC_AUTH_USER=admin N8N_BASIC_AUTH_PASSWORD=password |
Essas variáveis ativam a autenticação básica HTTP, exigindo credenciais para todas as tentativas de acesso.
Testando Nós Personalizados Localmente
A documentação oficial explica como testar nós personalizados durante o desenvolvimento. Instale o n8n globalmente primeiro, em seguida, construa e vincule o pacote do nó personalizado.
No diretório do nó personalizado, execute:
| npm run build npm link |
Em seguida, navegue até o diretório de nós do n8n (geralmente ~/.n8n/custom/) e vincule o pacote:
| npm link <nome-do-pacote-do-nó> |
O nó personalizado aparece na interface do n8n após reiniciar a instância.
Recursos de Automação Úteis para Usar com n8n
Se você está aprendendo a executar o n8n localmente e testando fluxos de trabalho em sua máquina, também pode se beneficiar de ajudantes e modelos externos que facilitam a automação de tarefas comuns. Get AI Perks oferece uma biblioteca de modelos de fluxo de trabalho e ferramentas assistidas por IA que você pode usar em conjunto com o n8n ou para prototipar ideias de automação antes de construí-las você mesmo.
Com Get AI Perks, você pode:
- Começar com modelos de fluxo de trabalho pré-construídos
- Obter assistência de IA para lógica e conteúdo rotineiros
- Explorar padrões de automação comuns antes de implementá-los no n8n
- Combinar modelos com sua configuração local do n8n
Descubra Get AI Perks para encontrar ajudantes de automação que suportam seus fluxos de trabalho n8n.
Solução de Problemas Comuns
Conflitos de porta representam o problema de instalação mais frequente. Se a porta 5678 já estiver em uso, pare o serviço conflitante ou altere a porta do n8n usando a variável de ambiente N8N_PORT.
Incompatibilidade de Versão do Nó
Usar versões do Node.js fora da faixa 20.19-24.x causa falhas na instalação. O repositório GitHub do n8n documenta problemas quando desenvolvedores tentam ambientes de desenvolvimento local, destacando a importância da compatibilidade da versão do Node.
Verifique a compatibilidade da versão do Node antes de solucionar outros problemas. Alterne as versões do Node usando nvm (Node Version Manager), se necessário.
Erros de Permissão de Volume Docker
Problemas de permissão com o montagem de volume ~/.n8n impedem a persistência de dados. Contêineres Docker são executados como o usuário node, que pode não ter acesso de escrita ao diretório do host.
Crie o diretório com as permissões apropriadas antes de iniciar o contêiner:
| mkdir ~/.n8n chmod 777 ~/.n8n |
Perguntas Frequentes
O n8n pode rodar sem acesso à internet?
Sim, o n8n funciona completamente offline para fluxos de trabalho locais. A conectividade com a internet só se torna necessária quando os fluxos de trabalho interagem com APIs externas ou serviços em nuvem.
Quanto custa executar o n8n localmente?
Instalações locais são gratuitas. A edição comunitária fornece todos os recursos principais sem taxas de licenciamento. A hospedagem em nuvem começa com limites de execução e custos mensais, mas a hospedagem local remove essas restrições completamente, de acordo com discussões da comunidade.
Iniciantes devem usar npm ou Docker?
Iniciantes testando o n8n devem começar com npx para acesso imediato. O Docker faz mais sentido para uso contínuo, pois oferece melhor isolamento e atualizações mais fáceis.
Onde o n8n armazena os dados do fluxo de trabalho localmente?
O diretório de dados padrão é ~/.n8n na pasta home do usuário. Este local contém arquivos de banco de dados SQLite, credenciais e logs de execução, a menos que configurado de outra forma.
Várias instâncias do n8n podem rodar em uma máquina?
Sim, mas cada instância precisa de uma porta única. Defina portas diferentes usando a variável de ambiente N8N_PORT para cada instância. O Docker facilita isso através do mapeamento de portas em contêineres separados.
Como funcionam as atualizações para instalações locais?
Instalações npm são atualizadas via npm update -g n8n ou npm install -g n8n@latest. Usuários Docker puxam a imagem mais recente com docker pull n8nio/n8n, e então recriam os contêineres. Sempre faça backup do diretório ~/.n8n antes de atualizar.
Considerações de Produção
A documentação oficial do n8n enfatiza que a auto-hospedagem requer conhecimento técnico. Configurar servidores, gerenciar recursos e proteger aplicações exigem experiência em administração de sistemas.
Para implantações de produção, o Docker Compose fornece a base. Adicione um proxy reverso como nginx ou Caddy para suporte a HTTPS. O repositório n8n-hosting inclui configurações do Caddy prontas para implantação.
A seleção do banco de dados é importante para cargas de trabalho pesadas. O banco de dados SQLite padrão funciona para uso moderado, mas o PostgreSQL oferece melhor desempenho para automação de alto volume, de acordo com orientações oficiais.
Fazendo a Escolha: Local vs Nuvem
A hospedagem local do n8n é adequada para equipes com capacidades técnicas e requisitos de segurança específicos. Os dados permanecem em infraestrutura controlada, e os limites de execução desaparecem.
No entanto, a hospedagem local requer manutenção, backups e monitoramento. A hospedagem em nuvem transfere essas responsabilidades para a equipe de infraestrutura do n8n. Verifique o site oficial para preços atuais e comparações de recursos na nuvem.
Executar o n8n localmente oferece controle total sobre a infraestrutura de automação de fluxo de trabalho. Seja usando npm para testes rápidos ou Docker para implantações de produção, ambos os métodos entregam a plataforma completa sem custos recorrentes. Comece com npx para exploração imediata, depois transite para Docker quando os fluxos de trabalho se aproximarem do uso em produção.
