O n8n se consolidou como uma das ferramentas de automação de fluxos de trabalho mais populares do mercado. Se você quer instalar n8n localmente no computador e ter controle total sobre seus dados e processos, este guia foi escrito especificamente para você. Ao longo deste artigo, você vai entender cada etapa da instalação, os métodos disponíveis e as melhores práticas para colocar o n8n em funcionamento na sua própria máquina.
O Que É o n8n e Por Que Instalá-lo Localmente
Antes de mergulhar na instalação, vale entender o que torna o n8n tão relevante. O n8n é uma plataforma open source de automação que permite conectar aplicativos, APIs e serviços por meio de uma interface visual baseada em nós. Em outras palavras, você constrói fluxos de trabalho arrastando e conectando blocos — sem precisar escrever código do zero para cada integração.
Vantagens da instalação local frente à versão cloud
Ao instalar n8n localmente no computador, você ganha benefícios que a versão cloud simplesmente não oferece. Em primeiro lugar, há o controle total sobre seus dados: todas as credenciais, workflows e informações sensíveis ficam armazenados na sua máquina, sem passar por servidores de terceiros. Além disso, você elimina custos recorrentes de assinatura, já que a versão self-hosted é gratuita.
Por outro lado, a instalação local exige um pouco mais de conhecimento técnico. No entanto, como você verá nas próximas seções, o processo é surpreendentemente simples — especialmente com Docker.
💡 Destaque positivo: Ao rodar o n8n na sua própria máquina, você garante conformidade com a LGPD e outras normas de privacidade, já que nenhum dado sensível trafega por servidores externos. Essa é uma vantagem estratégica para profissionais e empresas que lidam com informações confidenciais de clientes.
Requisitos Mínimos Para Instalar n8n Localmente no Computador
Antes de iniciar a instalação, certifique-se de que seu computador atende aos requisitos mínimos. Dessa forma, você evita erros e garante uma experiência fluida desde o início.
Hardware recomendado
O n8n é uma ferramenta leve, porém o desempenho depende da complexidade dos seus workflows. Veja as especificações:
| Recurso | Mínimo | Recomendado |
|---|---|---|
| Processador | 1–2 núcleos (vCPU) | 2+ núcleos |
| Memória RAM | 1–2 GB | 4 GB ou mais |
| Armazenamento | 10 GB livres | 30 GB SSD |
| Sistema operacional | Windows 10/11, macOS 12+ ou Linux | Qualquer um dos três |
Software necessário conforme o método escolhido
Você pode instalar o n8n por dois caminhos principais: Docker ou npm (Node.js). Cada método tem seu próprio pré-requisito de software:
- Método Docker: Docker Desktop instalado e em execução.
- Método npm: Node.js versão 18 ou superior (LTS) com npm incluso.
Ambas as opções levam ao mesmo resultado: o n8n rodando em http://localhost:5678. A diferença está na forma como ele é gerenciado, como detalhamos a seguir.
Método 1 — Instalar n8n com Docker (Recomendado)
O Docker é o método mais indicado pela comunidade e pela própria equipe do n8n. Ele cria um container isolado, o que significa que a ferramenta não interfere em nenhum outro software do seu sistema. Além disso, o Docker facilita atualizações, backups e a persistência dos seus dados.
⚠️ Ponto de atenção: Usar o n8n com o Docker é o método mais recomendado para que você não perca seus projetos de automação ao rodar o n8n localmente no seu próprio computador. Pode ser necessário atualizar o Windows Subsystem for Linux (WSL), que é um recurso que permite executar distribuições Linux diretamente no Windows, sem a necessidade de criar máquinas virtuais tradicionais. Se isso for necessário, você será avisado na primeira vez que executar o Docker.
Passo 1: Instalar o Docker Desktop
Acesse o site oficial do Docker em docker.com/get-started e baixe a versão compatível com o seu sistema operacional. Após a instalação, abra o Docker Desktop e aguarde até que o indicador de status fique verde, confirmando que o serviço está ativo.
Passo 2: Criar um volume para persistência de dados
O volume garante que seus workflows e credenciais não sejam perdidos quando o container for reiniciado. Para criá-lo, abra o terminal (PowerShell no Windows, Terminal no macOS/Linux) e execute:
docker volume create n8n_data
Esse comando cria um espaço de armazenamento dedicado. Dessa forma, mesmo que você atualize ou recrie o container, todas as suas automações continuarão intactas.
Passo 3: Baixar e executar o container do n8n
Com o volume pronto, execute o seguinte comando para iniciar o n8n:
docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n
Esse comando faz três coisas simultaneamente: baixa a imagem oficial do n8n, mapeia a porta 5678 do container para a porta 5678 do seu computador e vincula o volume de dados que criamos.
Passo 4: Acessar a interface do n8n
Assim que o terminal exibir uma mensagem indicando que o n8n está pronto, abra o navegador e acesse:
http://localhost:5678Você verá a tela de configuração inicial, onde precisará criar seu primeiro usuário e senha. A partir daí, já pode começar a montar seus workflows de automação.
⚠️ Ponto de atenção: O Docker Desktop consome recursos do sistema mesmo quando nenhum container está ativo. Se o seu computador tiver pouca memória RAM (abaixo de 4 GB), considere o método npm como alternativa mais leve — ou feche o Docker Desktop quando não estiver usando o n8n.
Método 2 — Instalar n8n com npm e Node.js
Se você já trabalha com desenvolvimento ou prefere não usar o Docker, o método via npm é rápido e direto. No entanto, ele exige que você gerencie manualmente as versões do Node.js e possíveis conflitos de dependências.
Passo 1: Instalar o Node.js (versão LTS)
Acesse nodejs.org e baixe a versão LTS (Long-Term Support). Após a instalação, verifique se tudo está funcionando corretamente executando no terminal:
npm -v
Ambos os comandos devem retornar um número de versão. Se isso não acontecer, reinicie o terminal ou verifique se o Node.js foi adicionado ao PATH do sistema.
Passo 2: Instalar o n8n globalmente
Com o Node.js configurado, instale o n8n como pacote global:
npm install -g n8n
No Linux ou macOS, caso encontre erros de permissão, adicione sudo antes do comando. Em seguida, aguarde a conclusão do download — o processo pode levar alguns minutos dependendo da velocidade da sua conexão.
Passo 3: Iniciar o n8n
Para colocar o n8n em funcionamento, basta abrir o prompt de comando (aperte as teclas Windows + R; e depois digite cmd ).
Com o terminal aberto digite:
n8n
O terminal mostrará logs de inicialização e, assim que exibir a URL de acesso, abra o navegador em http://localhost:5678. Pronto — o n8n está rodando nativamente no seu sistema.
Alternativa rápida com npx (sem instalação permanente)
Se você quer apenas testar o n8n sem instalá-lo permanentemente, use:
npx n8n
Esse comando baixa e executa o n8n temporariamente. Como resultado, nenhum pacote fica instalado de forma global no seu sistema — ideal para uma avaliação rápida.
Docker ou npm: Qual Método Escolher Para Seu Cenário
A escolha entre Docker e npm depende do seu perfil e do uso pretendido. Para facilitar a decisão, veja esta comparação objetiva:
| Critério | Docker | npm (Node.js) |
|---|---|---|
| Isolamento | Total — container independente | Nenhum — compartilha o ambiente do host |
| Facilidade de atualização | Simples — basta recriar o container | Manual — requer npm update |
| Persistência de dados | Via volumes dedicados | Via diretório local ~/.n8n |
| Consumo de recursos | Moderado (Docker Desktop ativo) | Baixo (apenas Node.js) |
| Melhor para | Uso contínuo e produção | Testes rápidos e desenvolvimento |
Portanto, se você pretende usar o n8n de forma consistente e precisa de estabilidade, o Docker é a escolha mais segura. Por outro lado, se você quer apenas experimentar ou já tem um ambiente Node.js configurado, o npm é perfeitamente funcional.
Leia também: Como criar seu primeiro workflow de automação no n8n — um guia passo a passo para iniciantes.
Primeiros Passos Após a Instalação do n8n Local
Com o n8n rodando, o próximo passo é configurá-lo adequadamente para aproveitar todo o potencial da ferramenta. Nesse contexto, existem algumas ações essenciais que você deve realizar logo após a primeira execução.
Criar o usuário administrador
Na primeira vez que acessar http://localhost:5678, o n8n solicita a criação de um usuário e senha. Esse passo é obrigatório e garante que somente pessoas autorizadas possam acessar seus workflows e credenciais.
Explorar os templates de workflows
O n8n oferece uma biblioteca de templates prontos que facilitam o aprendizado. Especialmente para quem está começando, esses modelos são um ponto de partida excelente para entender como os nós se conectam e como os dados fluem entre as etapas.
Configurar credenciais de serviços externos
Para que o n8n se comunique com ferramentas como Google Sheets, Slack, WhatsApp ou bancos de dados, você precisa cadastrar as credenciais de acesso (chaves de API, tokens OAuth etc.). Acesse o menu Credenciais no painel lateral e adicione os serviços que pretende integrar.
Configurar backup dos dados
Se você usou o Docker, seus dados já estão protegidos no volume n8n_data. Ainda assim, é recomendável exportar seus workflows periodicamente em formato JSON. No método npm, os dados ficam armazenados na pasta ~/.n8n — faça backups regulares dessa pasta para evitar perdas.
Confira também: 5 automações essenciais com n8n para pequenas empresas — ideias práticas para começar a automatizar hoje.
Perguntas Frequentes Sobre Instalar n8n Localmente
O n8n local é realmente gratuito?
Sim. O n8n é distribuído sob licença fair-code, portanto a versão self-hosted (instalada no seu próprio computador) é totalmente gratuita. Além disso, não há limite de execuções ou workflows. A versão paga existe apenas para quem prefere a comodidade da hospedagem gerenciada na nuvem (n8n Cloud).
Preciso saber programar para usar o n8n?
Não necessariamente. A interface visual do n8n permite criar automações arrastando e conectando nós, sem escrever código. No entanto, conhecimentos básicos de lógica e APIs enriquecem bastante a experiência. De fato, usuários que dominam JavaScript ou Python conseguem criar integrações significativamente mais avançadas.
Posso acessar o n8n local de outro dispositivo na mesma rede?
Sim, desde que você conheça o IP local da máquina onde o n8n está rodando. Em vez de acessar localhost:5678, use o endereço IP (por exemplo, 192.168.1.100:5678) a partir de qualquer dispositivo conectado à mesma rede Wi-Fi. Dessa forma, você pode monitorar e editar workflows até mesmo pelo celular.
Como atualizo o n8n para a versão mais recente?
O processo depende do método de instalação. Se você utiliza Docker, pare o container atual e execute novamente o comando docker run com a imagem mais recente — o Docker baixará automaticamente a atualização. Se utiliza npm, execute npm update -g n8n no terminal. Em ambos os casos, seus dados são preservados desde que o volume ou a pasta ~/.n8n estejam configurados corretamente.
Instalar n8n localmente no computador é um processo acessível que coloca em suas mãos uma das ferramentas de automação mais poderosas e flexíveis do mercado. Seja pelo Docker ou pelo npm, você ganha autonomia total sobre seus dados, elimina custos de assinatura e abre caminho para automatizar tarefas repetitivas com eficiência. Dessa forma, o investimento de poucos minutos na instalação se transforma em horas de produtividade recuperadas a cada semana.
Se tiver ficado alguma dúvida, fique à vontade para perguntar nos comentários.
