n8n-operator

N8n Kubernetes Operator

A Kubernetes operator that automates the deployment and management of n8n workflow automation instances on Kubernetes clusters.

Key Features

• Automated Deployment: Simplified n8n instance deployment with PostgreSQL database configuration
• Traffic Routing: Support for both Kubernetes Ingress and Gateway API HTTPRoute
• Persistent Storage: Automatic volume provisioning and configurable storage management
• Security: Non-root container execution with automated TLS configuration
• Monitoring: Prometheus metrics integration for operational visibility

Quick Start

Create a basic n8n instance:

apiVersion: n8n.slys.dev/v1alpha1
kind: N8n
metadata:
  name: n8n-sample
spec:
  database:
    postgres:
      host: "postgres-host"
      port: 5432
      database: "n8n"
      user: "n8n-user"
      password: "password"
  ingress:
    enable: true
    ingressClassName: "nginx"

📖 Documentation

Read the full documentation →

For comprehensive guides and detailed configuration options, visit our complete documentation:

• Installation Guide - Get started with installation and setup
• Configuration Guide - Complete configuration reference
• API Reference - Custom Resource Definitions and specifications

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the Apache License, Version 2.0. See the LICENSE file for details.