Olá galera, tudo bem com vocês?
Nesse post será abordado duas formas de instalar localmente a ferramenta N8N e já utilizá-la para automatizar processos.
Tópicos:
- Instalação via npm
- Requisitos para rodar o n8n localmente
- Para instalar o Node.JS
- Instalação via npm
- Instalação via Docker
Instalação via npm
O npm é o gerenciador de pacotes padrão para o Node.js. Ele facilita a instalação, gerenciamento e compartilhamento de bibliotecas e ferramentas JavaScript, permitindo que desenvolvedores criem e gerenciem aplicações de forma mais eficiente.
Nesse caso utilizaremos uma versão dele para instalar e rodar a plataforma N8N.
Requisitos para rodar o n8n localmente
Certifique-se de ter as ferramentas básicas instaladas no seu sistema:
- Node.js (versão 16 ou superior)
- npm (gerenciador de pacotes do Node.js)
Para instalar o Node.JS
Aqui está um guia simplificado para instalar o Node.js no Windows e no Linux:
No Windows
- Baixe o instalador:
- Acesse o site oficial do Node.js: https://nodejs.org.
- Baixe a versão recomendada (LTS) para maior estabilidade.
- Execute o instalador:
- Clique no arquivo baixado (ex:
node-vxx.x.x-x64.msi
). - Siga os passos da instalação:
- Aceite os termos de uso.
- Escolha o caminho de instalação (deixe o padrão, geralmente em
C:\Program Files\nodejs
). - Certifique-se de marcar a opção “Automatically install necessary tools” (se disponível).
- Clique no arquivo baixado (ex:
- Verifique a instalação:
- Após a instalação, abra o Prompt de Comando (cmd) ou o PowerShell.
- Execute os comandos:
- Esses comandos devem retornar as versões do Node.js e do npm.
node -v npm -v
No Linux
**Método 1: Usando o gerenciador de pacotes **
- Atualize os pacotes:
sudo apt update sudo apt upgrade -y
- Instale o Node.js (versão LTS):
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt install -y nodejs
- Verifique a instalação:
node -v npm -v
Método 2: Usando nvm (Node Version Manager)
Se deseja gerenciar várias versões do Node.js no mesmo sistema:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
- Ative o nvm (se necessário):
source ~/.bashrc
- Instale a versão LTS do Node.js:
nvm install --lts
- Verifique a instalação:
node -v npm -v
Instalação via npm
Agora com o NodeJS e o NPM instalado, realize a instalação do N8N
Passos:
- Instale o pacote do n8n globalmente:
npm install -g n8n
- Execute o n8n:
n8n
- Acesse a interface no navegador em:
http://localhost:5678
Instalação via Docker
Caso não tenha o Docker instalado na sua máquina, siga os passos de instalação:
- https://docs.docker.com/get-started/get-docker/
A execução com Docker é a maneira mais prática, pois você não precisa configurar dependências.
Passos:
- Crie uma pasta para o projeto n8n:
mkdir n8n && cd n8n
- Crie um arquivo
docker-compose.yml
com o seguinte conteúdo:
version: "3" services: n8n: image: n8nio/n8n ports: - "5678:5678" environment: - N8N_BASIC_AUTH_ACTIVE=true - N8N_BASIC_AUTH_USER=admin - N8N_BASIC_AUTH_PASSWORD=admin123 volumes: - ./data:/home/node/.n8n
- Suba o container:
docker-compose up -d
- Acesse no navegador:
http://localhost:5678