n8n Deploy

🚀 Deploy n8n anywhere - AWS Serverless, Docker, or On-Premise - with enterprise features at personal costs

n8n Deploy is a comprehensive deployment platform for n8n workflow automation. Whether you need a $5/month personal instance, a scalable cloud deployment, or an on-premise solution with zero-trust security, n8n Deploy has you covered.

🎯 Choose Your Deployment

☁️ AWS Serverless From $5/month Perfect for personal projects and startups. Auto-scaling, managed infrastructure, pay-per-use. Deploy to AWS →

🐳 Docker Local Free Ideal for development, testing, or self-hosted deployments. Full control, no cloud costs. Run Locally →

🔒 Cloudflare Tunnel Zero-Trust Access Enterprise security without complexity. No public IPs, built-in DDoS protection. Setup Tunnel →

🌟 Why n8n Deploy?

• 🎛️ One Platform, Multiple Targets: Same configuration deploys to AWS, Docker, or hybrid setups
• 💰 Cost-Optimized: Start from $5/month on AWS, or run free locally
• 🔧 Production-Ready: Monitoring, backups, auto-scaling, and disaster recovery included
• 🛡️ Enterprise Security: Zero-trust options, secrets management, compliance templates
• 📊 Full Observability: Built-in dashboards for n8n metrics, costs, and performance
• 🚀 Quick Start: Deploy in under 5 minutes with sensible defaults

📊 Deployment Comparison

Feature	AWS Serverless	Docker Local	Cloudflare Tunnel
Starting Cost	$5-10/month	Free	Free (<50 users)
Scaling	Auto-scaling	Manual	Manual
Maintenance	Fully managed	Self-managed	Self-managed
Public IP Required	No	Optional	No
SSL/TLS	Automatic	Manual/Let's Encrypt	Automatic
Monitoring	CloudWatch	Prometheus/Grafana	Cloudflare Analytics
Backup	Automated	Manual/Scripted	Manual/Scripted
Best For	SaaS, Startups	Development, On-premise	Zero-trust, Enterprise

🚀 Quick Start

AWS Serverless Deployment

# Clone and deploy
git clone https://github.com/ArtemioPadilla/n8n-deploy
cd n8n-deploy
make install
make deploy-aws environment=production

Docker Local Deployment

# Clone and run locally
git clone https://github.com/ArtemioPadilla/n8n-deploy
cd n8n-deploy
make local-up

# Or use docker-compose directly
docker-compose up -d

Cloudflare Tunnel Deployment

# Clone and setup tunnel
git clone https://github.com/ArtemioPadilla/n8n-deploy
cd n8n-deploy
./scripts/cloudflare-tunnel-rotate.sh -e production

📋 Features

Core Features

• ✅ Multi-deployment support: AWS, Docker, Kubernetes, Cloudflare
• ✅ Configuration-driven: Single system.yaml for all settings
• ✅ Environment management: Dev, staging, production presets
• ✅ Cost optimization: Spot instances, auto-scaling, resource limits
• ✅ Security first: Secrets management, IAM roles, network isolation

AWS Serverless Features

• 🚀 ECS Fargate: Serverless containers with Spot support (70% savings)
• 💾 Flexible Storage: EFS for workflows, optional RDS for scale
• 🌐 API Gateway: Cost-effective alternative to load balancers
• 📊 CloudWatch: Full monitoring and alerting
• 🔄 Auto-scaling: CPU/memory-based scaling policies

Docker Features

• 🐳 Production-ready: Nginx reverse proxy, SSL, health checks
• 📊 Full monitoring: Prometheus, Grafana, and n8n dashboards
• 💾 Multiple databases: SQLite, PostgreSQL, MySQL support
• 🔄 Automated backups: Scheduled backups with retention
• 🔧 Development mode: Hot-reload and debugging tools

Cloudflare Tunnel Features

• 🔒 Zero-trust networking: No exposed ports or public IPs
• 🌍 Global edge network: Built-in DDoS protection
• 👥 Access control: Email/domain-based authentication
• 📊 Analytics: Real-time metrics and security insights
• 🚀 Easy setup: One-command tunnel creation

📁 Project Structure

n8n-deploy/
├── n8n_deploy/              # Main Python package
│   ├── stacks/             # CDK stack definitions
│   ├── constructs/         # Reusable components
│   └── config/             # Configuration management
├── docker/                  # Docker configurations
│   ├── grafana/            # Grafana dashboards
│   └── workflows/          # Example workflows
├── scripts/                 # Automation scripts
│   ├── local-deploy.sh     # Local deployment
│   ├── local-setup.sh      # Environment setup
│   └── cloudflare-tunnel-rotate.sh  # Tunnel management
├── config/                  # Configuration files
│   └── system.yaml         # Main configuration
├── docs/                    # Documentation
└── tests/                   # Test suites

🔧 Configuration

All deployments use a unified system.yaml configuration:

# config/system.yaml
project:
  name: "my-n8n"
  deployment_type: "aws"  # or "docker", "cloudflare"

environments:
  production:
    n8n:
      version: "1.94.1"
      encryption_key: "{{ secrets.n8n_encryption_key }}"

    # AWS-specific settings
    aws:
      account: "123456789012"
      region: "us-east-1"
      fargate:
        cpu: 512
        memory: 1024
        spot_enabled: true

    # Docker-specific settings
    docker:
      compose_profile: "production"
      postgres_enabled: true
      redis_enabled: true

    # Cloudflare-specific settings
    cloudflare:
      tunnel_name: "n8n-production"
      access_policy:
        allowed_emails: ["[email protected]"]
        allowed_domains: ["example.com"]

📚 Documentation

• Getting Started - Interactive deployment guide
• Architecture Overview - System design and components
• Deployment Guide - Detailed deployment instructions
• Cost Optimization - Save money on cloud deployments
• Security Best Practices - Hardening and compliance
• Monitoring & Alerts - Observability setup
• Disaster Recovery - Backup and restore procedures
• Local Development - Development environment setup
• Local CI Testing - Test GitHub Actions locally with act
• Migration Guide - Migrate from other n8n deployments

💰 Cost Examples

Personal Use (AWS)

• Minimal: ~$5-10/month (256 CPU, 512MB RAM, SQLite)
• Standard: ~$15-20/month (512 CPU, 1GB RAM, PostgreSQL)

Team Use (AWS)

• Small Team: ~$30-50/month (1024 CPU, 2GB RAM, RDS)
• Medium Team: ~$75-100/month (2048 CPU, 4GB RAM, Aurora)

Enterprise (Hybrid)

• Cloudflare + AWS: ~$50-100/month (High availability, zero-trust)
• On-premise + Cloudflare: Infrastructure cost only

🛠️ Development

# Setup development environment
make install-dev

# Run tests
make test

# Run linting
make lint

# Start local development
make local-up

# Deploy to AWS dev environment
make deploy-dev

# View costs
make costs environment=production

# Test GitHub Actions locally
./scripts/act-test.sh

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Process

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests and linting
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• n8n - The fantastic workflow automation tool
• AWS CDK - Infrastructure as code framework
• Cloudflare - Zero-trust networking
• All our contributors and users

🔗 Links

• Repository: https://github.com/ArtemioPadilla/n8n-deploy
• Issues: GitHub Issues
• Discussions: GitHub Discussions

---

This software is provided 'as is' and without warranty of any kind, express or implied, including but not limited to the implied warranties of merchantability and fitness for a particular purpose.

---

Made with ❤️