...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
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.
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.
- 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 NVMEin 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
- CPU:
- 2 ร Lenovo Tiny M70q Gen.3
- CPU:
Intel Core i5-12400T - RAM:
16GB DDR4 - SSD:
256GB NVME
- CPU:
- 2 ร Lenovo Tiny M70q Gen.2
- CPU:
Intel Core i5-11400T - RAM:
16GB DDR4 - SSD:
256GB NVME
- CPU:
- 7 ร Lenovo Tiny M720q
- CPU:
Intel Core i5-8100T - RAM:
16GB - SSD:
512GB NVME
- CPU:
- 1 x NAS
- 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 |
 |
Deploy on real hardware for production workload.
...or simply:
โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ ๐ง โ
โ โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ โ
โ โ$ nix develop โ โ
โ โ$ make ktchn8s โ โ
โ โ... โ โ
โ โ โ โ
โ โ โ โ
โ โ โ โ
โ โ โ โ
โ โ ๐ โ โ
โ โ โ โ
โ โ โ โ
โ โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ โ
โ โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโโโ|โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ|โโโโฎ
_-' .-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-. --- `-_
_-'.-.-. .---.-.-.-.-.-.-.-.-.-.-.-.-.-.-.--. .-.-.`-_
_-'.-.-.-. .---.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-`__`. .-.-.-.`-_
_-'.-.-.-.-. .-----.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-----. .-.-.-.-.`-_
_-'.-.-.-.-.-. .---.-. .-------------------------. .-.---. .---.-.-.-.`-_
โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โฐโโโ._.โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ._.โโโโฏ
See roadmap and open issues for a list of proposed features and known issues.
Any contributions you make are greatly appreciated.
Please see contributing guide for more information.
Copyright ยฉ 2025 - present, serpro69
Distributed under the MIT License.
See license page or LICENSE.md file for more information.