Instalação Self-hosted do n8n

Guia para instalar e configurar localmente o pacote @ekyte/n8n-nodes-ekyte no n8n.

Objetivo do Guia de Instalação Self-hosted do n8n

Este guia te ajudará a instalar e configurar o n8n localmente (especificamente o pacote @ekyte/n8n-nodes-ekyte).

Disponível para planos Extremo e Enterprise.

Pré-requisitos

Instalar Node.js

Baixe e instale a versão mais recente estável do Node.js em: https://nodejs.org/
Versão recomendada: v22.18.0 ou superior

Para validar se a versão foi instalada corretamente, abra o Command Prompt, PowerShell ou Git Bash e execute:

node --version
npm --version

Caso exiba a versão correta, a instalação foi concluída com sucesso - caso contrário, é necessário reinstalar.

Instalar o n8n globalmente

Abra o terminal e execute o comando:

npm install -g n8n

*Este processo pode levar alguns minutos para completar.

Criar a estrutura de pastas

Vá para a pasta onde está seu usuário
- normalmente -> C:\Usuários\SEU-USUARIO
Em C:\Usuários\SEU-USUARIO - crie uma nova pasta com o nome: .n8n (com o ponto no início)

Dentro da pasta .n8n, crie uma outra pasta com o nome: nodes
via terminal, acesse a posta nodes, para o próximo passo.

Configurar o package.json

Após navegagar para pasta nodes.

Dentro da pasta nodes, crie o arquivo package.json, para isso, no terminal execute o comando:

echo {"name": "n8n-custom-nodes", "version": "1.0.0", "description": "Custom nodes for n8n"} > package.json

Verifique se o arquivo foi criado

Instalar o Node do eKyte

Ainda dentro da pasta nodes, execute no terminal:

npm install @ekyte/n8n-nodes-ekyte

*Este processo irá baixar e instalar o pacote com suas dependências.

Verificar a instalação

Local: C:\Usuários\SEU-USUARIO\.n8n\nodes\node_modules

Você deve ver uma pasta @ekyte dentro de node_modules.

Iniciar o n8n

No terminal execute o comando:

n8n start

Verifique se funcionou

Acesse http://localhost:5678 no seu navegador (ou a URL mostrada no terminal)
Procure por eKyte na lista de nodes disponíveis

Se você encontrar os nodes da Ekyte, a instalação foi bem-sucedida!

Resumo da Estrutura de Pastas

Após completar todos os passos, sua estrutura deve estar assim:

C:\Users\SEU-USUARIO\

└── .n8n\

    └── nodes\

        ├── package.json

        └── node_modules\

            └── @ekyte\

                └── n8n-nodes-ekyte\