[!WARNING] This operator is no longer actively developed. The current generation of this project is N8n Rustful Operator — Kubernetes operator in Rust that runs n8n from custom resources. Declare an n8n instance — single process or queue-mode cluster — and the operator reconciles for you. Just start there.

N8n Kubernetes Operator

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

Documentation Status

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.