Pular para o conteúdo principal

Instalação Self-hosted do n8n

Instalação Self-hosted do n8n​

Esta página detalha os métodos de instalação self-hosted do n8n, incluindo Docker (recomendado) e npm. Para uma visão geral de todos os métodos, consulte o Guia de Instalação – Visão Panorâmica.

Conhecimento Técnico Necessário​

A instalação self-hosted requer conhecimentos básicos de:

  • Docker (método recomendado)
  • Node.js e npm
  • Linha de comando
  • Gerenciamento de servidor

Método Docker (Recomendado)​

Pré-requisitos​

  • Docker instalado
  • Docker Compose (opcional, mas recomendado)
  • 2GB RAM mínimo
  • 10GB espaço em disco

Instalação Rápida​

# Baixar e executar n8n
docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

Com Docker Compose​

Crie um arquivo 

docker-compose.yml
:

version: '3.8'

services:
  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=SUA_SENHA_SEGURA_AQUI
    volumes:
      - ~/.n8n:/home/node/.n8n

Execute:

docker-compose up -d

Método npm (Desenvolvimento)​

Pré-requisitos​

  • Node.js 16+ instalado
  • npm ou yarn
  • 2GB RAM mínimo

Instalação​

# Instalar n8n globalmente
npm install n8n -g

# Ou usar npx
npx n8n

Executar​

# Iniciar n8n
n8n

# Ou com configurações específicas
n8n start --tunnel

Configuração​

Variáveis de Ambiente​

# Configurações básicas
N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=SUA_SENHA_SEGURA_AQUI

# Configurações de banco de dados
N8N_DATABASE_TYPE=postgresdb
N8N_DATABASE_POSTGRESDB_HOST=localhost
N8N_DATABASE_POSTGRESDB_DATABASE=n8n
N8N_DATABASE_POSTGRESDB_USER=n8n
N8N_DATABASE_POSTGRESDB_PASSWORD=SUA_SENHA_SEGURA_AQUI

Configurações de Produção​

  • Use HTTPS para todas as conexões
  • Configure backup automático
  • Monitore logs e performance
  • Use variáveis de ambiente para credenciais

Verificação da Instalação​

Teste Básico​

  1. Acesse 
    http://localhost:5678
  2. Crie uma conta de administrador
  3. Teste um workflow simples

Verificação de Logs​

# Docker
docker logs n8n

# npm
n8n start --verbose

Próximos passos​

  1. Criar Primeiro Workflow - Aprenda a criar workflows básicos
  2. Conectar Aplicações - Integre diferentes serviços
  3. Configuração Avançada - Configure para produção

A instalação é apenas o primeiro passo. O verdadeiro poder do n8n está na automação que você vai criar!

Dica Pro

Use Docker para instalação em produção, pois oferece melhor isolamento e facilidade de manutenção.

Importante

Sempre configure autenticação básica em ambientes de produção para proteger sua instância.

Recurso Adicional

Consulte a documentação oficial do n8n para configurações avançadas e troubleshooting.