Como utilizar localmente a plataforma N8N

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

  1. Baixe o instalador:
    • Acesse o site oficial do Node.js: https://nodejs.org.
    • Baixe a versão recomendada (LTS) para maior estabilidade.
  2. 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).
  3. 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
            1. Acesse no navegador:
            http://localhost:5678

            E por hoje é só, espero que tenham gostado!