A configuration generator for self-hosted n8n deployments. Generate Docker Compose files, environment variables, and Kubernetes manifests through an interactive web interface.

Visit the live application or run locally to configure your n8n instance.

Configuring n8n for production requires setting dozens of environment variables correctly. This tool:

• Eliminates manual documentation lookup for 80+ configuration options
• Validates dependencies (e.g., PostgreSQL fields when DB_TYPE=postgresdb)
• Generates deployment-ready configuration files
• Provides templates for common scenarios (minimal, production, queue-mode, enterprise)

git clone https://github.com/springmusk026/n8n-config-wizard.git
cd n8n-config-wizard
pnpm install
pnpm dev

Open http://localhost:3000

1. Select a deployment template or start with custom configuration
2. Configure variables across categories (Database, Security, Queue, etc.)
3. Review validation errors and fix any issues
4. Generate output in your preferred format
5. Download or copy the configuration

The wizard validates:

• Type checking: Numeric fields accept only numbers
• Dependencies: PostgreSQL fields required when DB_TYPE=postgresdb
• Dependencies: Redis fields required when EXECUTIONS_MODE=queue
• Required fields: Core configuration must be set before generation

# Install dependencies
pnpm install

# Development server
pnpm dev

# Run tests
pnpm test

# Production build
pnpm build

app/                      # Next.js pages
components/
  ui/                     # Base UI components (shadcn/ui)
  wizard/                 # Wizard-specific components
    config-form.tsx       # Variable configuration form
    category-sidebar.tsx  # Category navigation
    output-panel.tsx      # Generated output display
    template-selector.tsx # Template selection grid
lib/
  parser/                 # .env, YAML, JSON parsers
  validation/             # Validation rules engine
  n8n-config.ts          # Variable definitions
  diff.ts                # Configuration comparison
  template-manager.ts    # Custom template storage
__tests__/
  unit/                  # Unit tests
  properties/            # Property-based tests (fast-check)

• Next.js 16 / React 19
• TypeScript
• Tailwind CSS 4
• shadcn/ui
• Vitest + fast-check

• Deployment: Host, port, protocol, webhook URL
• Database: SQLite or PostgreSQL settings
• Executions: Timeouts, data retention, pruning
• Queue Mode: Redis connection, worker settings
• Security: Encryption key, authentication, cookies
• Logging: Log level, output format, file rotation
• SMTP: Email server configuration
• Storage: S3 external storage
• AI: LangChain, AI assistant settings
• Source Control: Git integration

Basanta Sapkota

• GitHub: @springmusk026

MIT with Attribution Requirement - You are free to use, modify, and distribute this software provided you:

• Credit the original author (Basanta Sapkota)
• Link to the original repository
• Keep the attribution in derivative works

See LICENSE for full terms.