DEV Community

Cover image for Como Instalar o n8n com Suporte a Pastas para Workflows - Guia Completo de Instalação Local
Roniere da silva marques
Roniere da silva marques

Posted on

Como Instalar o n8n com Suporte a Pastas para Workflows - Guia Completo de Instalação Local

Demonstração


Introdução

O n8n é uma poderosa ferramenta de automação de workflows, e uma das funcionalidades mais solicitadas pela comunidade é a organização de workflows em pastas. Neste guia, vou mostrar como instalar o n8n localmente e adicionar suporte para esta funcionalidade através de uma PR específica.

Pré-requisitos

Antes de começar, certifique-se de ter instalado:

  • Node.js (versão >= 18.10)
  • pnpm (versão >= 8.9)
  • Git
  • Sistema operacional: Windows, Linux ou macOS
  • Mínimo 4GB de RAM
  • 2GB de espaço em disco livre

Passo 1: Preparação do Ambiente

Primeiro, vamos instalar o pnpm se você ainda não tiver:

npm install -g pnpm
Enter fullscreen mode Exit fullscreen mode

Configure o pnpm:

pnpm setup
Enter fullscreen mode Exit fullscreen mode

Importante: Após executar o setup, abra um novo terminal para que as alterações tenham efeito.

Passo 2: Clonando o Repositório

Clone o repositório do n8n e acesse a pasta:

git clone https://github.com/n8n-io/n8n.git
cd n8n
Enter fullscreen mode Exit fullscreen mode

Passo 3: Adicionando a PR de Pastas

Adicione o repositório remoto da PR e faça o fetch:

git remote add romainminaud https://github.com/romainminaud/n8n.git
git fetch romainminaud
Enter fullscreen mode Exit fullscreen mode

Mude para a branch da PR:

git checkout workflows-in-folders
Enter fullscreen mode Exit fullscreen mode

Passo 4: Instalação das Dependências

Instale todas as dependências necessárias:

pnpm install --no-frozen-lockfile
Enter fullscreen mode Exit fullscreen mode

Passo 5: Construindo os Pacotes

É necessário construir os pacotes na ordem correta:

  1. Workflow
cd packages/workflow
pnpm build
Enter fullscreen mode Exit fullscreen mode
  1. Core
cd ../core
pnpm build
Enter fullscreen mode Exit fullscreen mode
  1. Nodes-base
cd ../nodes-base
pnpm build
Enter fullscreen mode Exit fullscreen mode
  1. Editor-ui
cd ../editor-ui
pnpm build
Enter fullscreen mode Exit fullscreen mode
  1. CLI
cd ../cli
pnpm build
Enter fullscreen mode Exit fullscreen mode

Passo 6: Iniciando o n8n

Volte para o diretório raiz e inicie o n8n:

cd ../..
pnpm start
Enter fullscreen mode Exit fullscreen mode

Acessando o n8n

Após a inicialização, você pode acessar o n8n através do navegador:

  • URL: http://localhost:5678
  • Email padrão: admin@example.com
  • Senha padrão: password

Solução de Problemas Comuns

Erro de Permissão no Windows

Se encontrar erros de permissão no Windows:

  1. Execute o PowerShell como administrador
  2. Execute: Set-ExecutionPolicy RemoteSigned
  3. Confirme com "S" ou "Y"

Problemas com o Turbo

Se encontrar problemas com o Turbo:

pnpm dlx turbo daemon clean
pnpm store prune
pnpm install --force
Enter fullscreen mode Exit fullscreen mode

Erros de Construção

Se encontrar erros durante a construção dos pacotes:

  1. Limpe o cache: pnpm store prune
  2. Remova node_modules: rm -rf node_modules
  3. Reinstale as dependências: pnpm install --force

Links Importantes

Observações Finais

  • Esta PR está em desenvolvimento e pode haver mudanças
  • A equipe do n8n está trabalhando em uma implementação mais robusta
  • Recomenda-se acompanhar o issue original para atualizações
  • Esta instalação é recomendada apenas para ambiente de desenvolvimento

Contribuindo

Se você encontrar problemas ou tiver sugestões, sinta-se à vontade para:

  1. Abrir uma issue no GitHub
  2. Participar da discussão na comunidade
  3. Contribuir com melhorias através de PRs

Recursos Adicionais


Este guia foi criado para ajudar a comunidade n8n. Se você encontrar algum erro ou tiver sugestões de melhoria, por favor, entre em contato.

Top comments (0)