Pular para o conteúdo principal

Instalação Desktop

Este guia detalha como instalar n8n Desktop para uso local e desenvolvimento, oferecendo uma experiência nativa e simplificada.

O que é o n8n Desktop?​

O n8n Desktop é uma aplicação nativa que permite executar o n8n localmente sem necessidade de configurações complexas de servidor ou Docker. É ideal para usuários que preferem uma experiência mais simples e integrada ao sistema operacional.

Principais Características:​

  • ✅ Instalação simples - Download e instalação direta
  • ✅ Interface nativa - Integração com o sistema operacional
  • ✅ Sem configuração - Funciona imediatamente após instalação
  • ✅ Sincronização - Conecta com n8n Cloud
  • ✅ Offline - Funciona sem conexão com internet
  • ✅ Portátil - Pode ser executado de qualquer lugar

Pré-requisitos​

Requisitos do Sistema​

  • Sistema Operacional: Windows 10+, macOS 10.15+, Linux (Ubuntu 18.04+)
  • RAM: Mínimo 4GB, recomendado 8GB+
  • Disco: 2GB livre para instalação
  • Processador: Dual-core ou superior
  • Rede: Conexão para download e atualizações

Requisitos Específicos por SO​

Windows​

  • Windows 10 ou superior (64-bit)
  • .NET Framework 4.7.2 ou superior
  • Visual C++ Redistributable

macOS​

  • macOS 10.15 (Catalina) ou superior
  • Processador Intel ou Apple Silicon

Linux​

  • Ubuntu 18.04+ ou distribuição compatível
  • GLIBC 2.17 ou superior

Instalação​

Windows​

Download e Instalação​

  1. Acesse n8n.io/desktop
  2. Baixe o instalador para Windows (.exe)
  3. Execute o arquivo baixado
  4. Siga o assistente de instalação
  5. Inicie o n8n Desktop

Instalação via Chocolatey​

# <ion-icon name="settings-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Instalar Chocolatey (se necessário)
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# <ion-icon name="settings-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Instalar n8n Desktop
choco install n8n-desktop

Instalação via Winget​

winget install n8n.n8n-desktop

macOS​

Download e Instalação​

  1. Acesse n8n.io/desktop
  2. Baixe o instalador para macOS (.dmg)
  3. Abra o arquivo .dmg
  4. Arraste o n8n para a pasta Applications
  5. Inicie o n8n Desktop

Instalação via Homebrew​

# <ion-icon name="settings-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Instalar Homebrew (se necessário)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# <ion-icon name="settings-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Instalar n8n Desktop
brew install --cask n8n-desktop

Linux​

Ubuntu/Debian​

# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Adicionar repositório
wget -qO- https://packages.n8n.io/gpg.key | sudo apt-key add -
echo "deb https://packages.n8n.io/ubuntu/ focal main" | sudo tee /etc/apt/sources.list.d/n8n.list

# <ion-icon name="settings-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Atualizar e instalar
sudo apt update
sudo apt install n8n-desktop

Fedora/RHEL​

# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Adicionar repositório
sudo dnf config-manager --add-repo https://packages.n8n.io/fedora/n8n.repo

# <ion-icon name="settings-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Instalar
sudo dnf install n8n-desktop

Snap (Ubuntu)​

sudo snap install n8n-desktop

Configuração Inicial​

Primeiro Acesso​

  1. Inicie o n8n Desktop
  2. Aguarde a inicialização (pode levar alguns segundos)
  3. Acesse a interface - geralmente em 
    http://localhost:5678
  4. Crie sua conta de administrador

Configurações Básicas​

# <ion-icon name="key-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Configurações padrão
Porta: 5678
Protocolo: http
Host: localhost
Timezone: Sistema operacional

Configurações Avançadas​

# <ion-icon name="settings-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Arquivo de configuração (opcional)
# <ion-icon name="analytics-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Windows: %APPDATA%\n8n\config.json
# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> macOS: ~/Library/Application Support/n8n/config.json
# <ion-icon name="grid-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Linux: ~/.config/n8n/config.json

{
  "port": 5678,
  "protocol": "http",
  "host": "localhost",
  "timezone": "America/Sao_Paulo",
  "logLevel": "info"
}

Sincronização com n8n Cloud​

Conectar com n8n Cloud​

  1. Abra o n8n Desktop
  2. Vá em Settings > Cloud
  3. Clique em "Connect to n8n Cloud"
  4. Faça login com sua conta n8n Cloud
  5. Escolha o workspace para sincronizar

Sincronização de Workflows​

  • Upload: Envie workflows locais para o Cloud
  • Download: Baixe workflows do Cloud para local
  • Sync: Mantenha ambos sincronizados
  • Backup: Use o Cloud como backup automático

Configurações de Sincronização​

{
  "cloudSync": {
    "enabled": true,
    "autoSync": true,
    "workspace": "seu-workspace",
    "syncInterval": 300000
  }
}

Estrutura de Arquivos​

Localização dos Dados​

# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Windows
%APPDATA%\n8n\

# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> macOS
~/Library/Application Support/n8n/

# <ion-icon name="grid-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Linux
~/.config/n8n/

Diretórios Importantes​

n8n/
├── workflows/          # Workflows salvos
├── credentials/        # Credenciais
├── logs/              # Logs da aplicação
├── config.json        # Configurações
└── database.sqlite    # Banco de dados local

Backup Manual​

# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Windows
xcopy "%APPDATA%\n8n" "C:\backup\n8n" /E /I

# <ion-icon name="grid-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> macOS/Linux
cp -r ~/.config/n8n ~/backup/n8n

Desenvolvimento​

Modo Desenvolvedor​

# <ion-icon name="key-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Habilitar modo desenvolvedor
# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Windows: n8n-desktop.exe --dev
# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> macOS: n8n-desktop --dev
# <ion-icon name="grid-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Linux: n8n-desktop --dev

Logs de Desenvolvimento​

# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Windows
%APPDATA%\n8n\logs\desktop.log

# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> macOS
~/Library/Application Support/n8n/logs/desktop.log

# <ion-icon name="grid-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Linux
~/.config/n8n/logs/desktop.log

Configuração para Desenvolvimento​

{
  "development": {
    "enabled": true,
    "logLevel": "debug",
    "devTools": true,
    "autoReload": true
  }
}

Segurança​

Configurações de Segurança​

  • Autenticação local - Conta de administrador
  • Criptografia - Dados criptografados localmente
  • Firewall - Use firewall do sistema operacional
  • Atualizações - Mantenha sempre atualizado

Boas Práticas​

# <ion-icon name="settings-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Configurar firewall (Windows)
netsh advfirewall firewall add rule name="n8n Desktop" dir=in action=allow protocol=TCP localport=5678

# <ion-icon name="settings-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Configurar firewall (macOS)
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add /Applications/n8n\ Desktop.app

# <ion-icon name="settings-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Configurar firewall (Linux)
sudo ufw allow 5678/tcp

Troubleshooting​

Problemas Comuns​

Aplicação não inicia​

# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Verificar logs
# <ion-icon name="analytics-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Windows: %APPDATA%\n8n\logs\desktop.log
# <ion-icon name="help-circle-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> macOS: ~/Library/Application Support/n8n/logs/desktop.log
# <ion-icon name="grid-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Linux: ~/.config/n8n/logs/desktop.log

# <ion-icon name="settings-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Reinstalar aplicação
# <ion-icon name="sparkles-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Desinstale e baixe novamente do site oficial

Porta já em uso​

# <ion-icon name="git-branch-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Verificar processo usando a porta
# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Windows
netstat -ano | findstr :5678

# <ion-icon name="grid-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> macOS/Linux
lsof -i :5678

# <ion-icon name="settings-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Alterar porta na configuração
{
  "port": 5679
}

Problemas de sincronização​

# <ion-icon name="git-network-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Verificar conexão com internet
ping cloud.n8n.io

# <ion-icon name="speedometer-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Limpar cache de sincronização
# <ion-icon name="speedometer-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Remova a pasta de cache e reconecte

Performance lenta​

# <ion-icon name="school-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Verificar recursos do sistema
# <ion-icon name="git-branch-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Windows: Task Manager
# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> macOS: Activity Monitor
# <ion-icon name="grid-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Linux: htop

# <ion-icon name="sparkles-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Aumentar memória disponível
# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Feche outras aplicações

Atualizações​

Atualizações Automáticas​

  • Habilitadas por padrão
  • Verificação diária de novas versões
  • Download automático de atualizações
  • Instalação manual requerida

Atualizações Manuais​

# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Verificar versão atual
# <ion-icon name="help-circle-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Vá em Help > About

# <ion-icon name="sparkles-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Baixar nova versão
# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Acesse n8n.io/desktop

# <ion-icon name="settings-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Instalar atualização
# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Execute o novo instalador

Configurações de Atualização​

{
  "updates": {
    "enabled": true,
    "checkInterval": 86400000,
    "autoDownload": true,
    "channel": "stable"
  }
}

Suporte​

Recursos de Ajuda​

  • Documentação oficial - Guias detalhados
  • Community Forum - Troca de experiências
  • Discord - Suporte em tempo real
  • GitHub Issues - Reportar bugs

Logs para Suporte​

# <ion-icon name="help-circle-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Coletar logs para suporte
# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Windows
copy "%APPDATA%\n8n\logs\*" "C:\temp\n8n-logs\"

# <ion-icon name="document-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> macOS
cp ~/Library/Application\ Support/n8n/logs/* ~/Desktop/n8n-logs/

# <ion-icon name="grid-outline" style={{ fontSize: '24px', color: '#ea4b71' }}></ion-icon> Linux
cp ~/.config/n8n/logs/* ~/Desktop/n8n-logs/

Próximos Passos​

Agora que você tem o n8n Desktop instalado:

  1. Criar Primeiro Workflow - Aprenda a construir workflows
  2. Conceitos Fundamentais - Entenda os fundamentos
  3. Integrações - Conecte suas aplicações

Outros Métodos de Instalação​

  • Docker - Containerização para produção
  • NPM - Instalação local para desenvolvimento
  • Cloud - Serviço hospedado oficial
Dica Pro

O n8n Desktop é ideal para usuários não-técnicos e desenvolvimento local. Para produção, considere n8n Cloud ou Docker.

Vantagens do Desktop
  • Instalação simples sem conhecimentos técnicos
  • Funciona offline para desenvolvimento
  • Sincronização com n8n Cloud
  • Interface nativa integrada ao sistema
Limitações

O n8n Desktop é para uso pessoal e desenvolvimento. Para produção e equipes, use n8n Cloud ou self-hosted.

Links úteis: