ktchn8s

...there's no place like ~

🚧 Fork in progress, expect some dust 🚧

/ˈkɪtʃ.ən.eɪts/ (“Kitch-en-ates”)

A homelab ☸️ kubernetes cluster 👾
...right in your kitchen 🚀💥

:material-star-circle-outline: Features ⟩ :material-rocket-launch: Getting Started ⟩ :material-file-document-multiple: Documentation

---

About

This project utilizes Infrastructure as Code and GitOps to automate provisioning, operating, and updating self-hosted services in my homelab. It can also be used as a framework to build your own homelab.

If you encounter an issue or want to contribute a fix or an improvement, please create a bug issue.
If you have a question or want to chat about this project, please create a new discussion.

Overview

This project is still in the experimental stage. This means, among other things, that:

• There might be breaking changes that may require a complete redeployment.
• A proper upgrade path is planned for the stable release.

More information can be found in the roadmap.

Hardware

• Network:
  • Cisco C1111-8P Router
  • Cisco C3560-GS-8P Switch
  • Eero 6 Router (used as access-point for WiFi at home)
• Servers:
  • 1 x NAS
    • Fractal Design Node 804 case
    • CWWK/Topton J6413 motherboard
    • CPU: Intel Celeron J6413
    • RAM: 2x 16GB DDR4
    • SSD: 2x 512GB WD RED NVME in a zfs mirror (OS)
    • HDD: 6x 18TB Seagate Exos (Storage)
  • 1 × Lenovo Tiny M70q Gen.3
    • CPU: Intel Core i5-12400T
    • RAM: 2x 16GB DDR4
    • SSD: 256GB NVME
  • 2 × Lenovo Tiny M70q Gen.3
    • CPU: Intel Core i5-12400T
    • RAM: 16GB DDR4
    • SSD: 256GB NVME
  • 2 × Lenovo Tiny M70q Gen.2
    • CPU: Intel Core i5-11400T
    • RAM: 16GB DDR4
    • SSD: 256GB NVME
  • 7 × Lenovo Tiny M720q
    • CPU: Intel Core i5-8100T
    • RAM: 16GB
    • SSD: 512GB NVME
  • 1 x HP EliteDesk 800 G3 Mini
    • CPU: Intel Core i5-7500 vPro
    • RAM: 16GB
    • SSD: 256GB SATA

Features

• Common applications: Gitea, Jellyfin, Paperless...
• Automated bare metal provisioning with PXE boot
• Automated Kubernetes installation and management
• Installing and managing applications using GitOps
• Automatic rolling upgrade for OS and Kubernetes
• Automatically update apps (with approval)
• Modular architecture, easy to add or remove features/components
• Automated certificate management
• Automatically update DNS records for exposed services
• VPN (Tailscale or Wireguard)
• Expose services to the internet securely with Cloudflare Tunnel
• CI/CD platform
• Private container registry
• Distributed storage
• Support multiple environments (dev, prod)
• Monitoring and alerting
• Automated backup and restore
• Single sign-on
• Infrastructure testing

Some demo videos and screenshots are shown here. They can't capture all the project's features, but they are sufficient to get a concept of it.

Demo Showcase
Homepage powered by... Homepage
Git server powered by Gitea
Continuous Integration with Woodpecker CI
Continuous Deployment with ArgoCD
Identity Management with Kanidm
Monitoring with Grafana

Getting Started

Deploy on real hardware for production workload.

...or simply:

           ╭──────────────────────────────────────────────────╮
           │                        🐧                        │
           │    ╭────────────────────────────────────────╮    │
           │    │$ nix develop                           │    │
           │    │$ make ktchn8s                          │    │
           │    │...                                     │    │
           │    │                                        │    │
           │    │                                        │    │
           │    │                                        │    │
           │    │                                        │    │
           │    │ 🚀                                     │    │
           │    │                                        │    │
           │    │                                        │    │
           │    ╰────────────────────────────────────────╯    │
           │                                                  │
           ╰──────────────────────────────────────────────────╯
                   ╰──────────────────────────────────╯
               ╭───|──────────────────────────────────|───╮
             _-'    .-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.  --- `-_
          _-'.-.-. .---.-.-.-.-.-.-.-.-.-.-.-.-.-.-.--.  .-.-.`-_
       _-'.-.-.-. .---.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-`__`. .-.-.-.`-_
    _-'.-.-.-.-. .-----.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-----. .-.-.-.-.`-_
 _-'.-.-.-.-.-. .---.-. .-------------------------. .-.---. .---.-.-.-.`-_
╭─────────────────────────────────────────────────────────────────────────╮
╰───._.─────────────────────────────────────────────────────────────._.───╯

Roadmap

See roadmap and open issues for a list of proposed features and known issues.

Contributing

Any contributions you make are greatly appreciated.

Please see contributing guide for more information.

License

Copyright © 2025 - present, serpro69

Distributed under the MIT License. See license page or LICENSE.md file for more information.