n8n

Version 1.1.6

2 Launchpads - Local/Docker and Coolify

Production-grade n8n workflow automation platform with Docker Compose, queue mode, distributed workers, and task runners.

Custom Fork Support: This deployment infrastructure can optionally run with a custom n8n fork (see Custom Fork Guide for details). By default, both local and Coolify deployments use the official n8nio/n8n:latest image.

Deployment Options

This project supports two deployment forms:

See Deployment Comparison for detailed differences.

Quick Start (WSL2 Local)

# Start all services
docker compose up -d

# Access n8n (local)
open http://localhost:5678

# Access n8n (external via ngrok)
open https://your.ngrok.domain

Quick Start (Coolify)

See Deploy to Coolify for cloud deployment.

Repository Structure

.
├── config/              # Service configuration
│   ├── ngrok.yml        # ngrok tunnel configuration
│   ├── postgresql.conf  # PostgreSQL tuning
│   ├── postgres-init.sql # Database initialization
│   ├── n8n-task-runners.json # Task runner configuration (JS + Python)
│   ├── daemon.json      # Docker daemon settings
│   └── cron/            # Scheduled task configs
├── data/                # Runtime data (gitignored)
│   ├── n8n/             # n8n user data
│   ├── postgres/        # PostgreSQL data
│   ├── redis/           # Redis data
│   └── benchmark/       # Benchmark results
├── backups/             # Backup destination
│   ├── postgres/        # Database backups
│   ├── redis/           # Redis snapshots
│   ├── n8n/             # n8n workflow exports
│   ├── ngrok/           # Tunnel config backups
│   └── env/             # Environment backups
├── scripts/             # Operational scripts (22 scripts)
├── docs/                # Documentation (26 guides)
│   └── ongoing-roadmap/ # Future development docs
├── tests/               # BATS test files (22 tests)
├── logs/                # Application logs
├── docker-compose.yml           # WSL2/Local stack definition
└── docker-compose.coolify.yml   # Coolify stack definition

Services

External Network Integration

The stack connects to an external Ollama network for local LLM support:

• Network: lore-sage_luminari-network
• Models: deepseek-r1:8b, qwen2.5:7b, nomic-embed-text
• See Local LLM Integration for configuration

Documentation

Deployment Guides

• Deployment Comparison - WSL2 vs Coolify side-by-side
• Installation Plan (WSL2) - Complete local setup guide
• Deploy to Coolify - Cloud deployment guide
• Migration Guide - Moving from WSL2 to Coolify

Getting Started

• Onboarding - Zero-to-running checklist (WSL2)
• Architecture - System design (both deployments)
• Deployment Status - Current system state
• Development - Day-to-day commands

Operations

• Runbook - Daily/weekly/monthly operations
• Monitoring - Health and metrics
• Scaling - Worker scaling configuration
• Auto-Scaling - Queue-based automatic scaling
• Tunnels - ngrok tunnel and external access

Advanced Features

• Task Runners - External code execution (JS + Python)
• Local LLM Integration - Ollama integration for AI workflows
• Custom Fork - Custom n8n fork configuration

Maintenance

• Troubleshooting - Problem diagnosis
• Recovery - Disaster recovery procedures
• Disaster Recovery - Full DR procedures
• Upgrade - Version upgrade procedures
• Security - Security and OAuth

Backup & Storage

• Backup Encryption - GPG encryption for backups
• Log Management - Log rotation and cleanup

Reference

• PostgreSQL Tuning - Database optimization
• Port Assignments - Network configuration
• Environments - Environment configuration

Tech Stack

Common Commands

# Service management
docker compose up -d              # Start all services
docker compose down               # Stop all services
docker compose ps                 # View service status

# Health and monitoring
./scripts/system-status.sh        # Full status dashboard
./scripts/health-check.sh         # Quick health check
curl localhost:5678/healthz       # n8n health endpoint
./scripts/queue-depth.sh          # Check queue depth

# Tunnel management
./scripts/tunnel-manage.sh status   # Tunnel status
./scripts/tunnel-manage.sh restart  # Restart tunnel
./scripts/tunnel-status.sh          # Detailed tunnel info

# Worker and scaling
./scripts/worker-autoscale.sh       # Auto-scale based on queue
./scripts/monitor-resources.sh      # Resource monitoring

# Backup and maintenance
./scripts/backup-all.sh           # Full backup (postgres, redis, n8n, env)
./scripts/backup-postgres.sh      # Database backup only
./scripts/restore-postgres.sh     # Restore from backup
./scripts/cleanup-backups.sh      # Clean old backups
./scripts/cleanup-logs.sh         # Clean old logs
./scripts/view-logs.sh -f         # Follow logs

# Testing and verification
./scripts/verify-versions.sh      # Verify component versions
./scripts/postgres-benchmark.sh   # Database performance test
./scripts/test-recovery.sh        # Test recovery procedures

Scripts Reference