{
"markdown": "# ktchn8s\n\n\n\n_...there's no place like_ `~`\n\n๐ง Fork in progress, expect some dust ๐ง\n\n[](https://github.com/serpro69/ktchn8s/tags)\n[](https://opensource.org/license/mit)\n[](https://github.com/serpro69/ktchn8s)\n[](https://serpro69.github.io/ktchn8s)\n\n
\n\n> `/หkษชtส.ษn.eษชts/` (โKitch-en-atesโ)\n\nA homelab โธ๏ธ kubernetes cluster ๐พ\n
...right in your kitchen ๐๐ฅ\n\n\n\n**[:material-star-circle-outline: Features](#features) โฉ [:material-rocket-launch: Getting Started](#getting-started) โฉ [:material-file-document-multiple: Documentation](https://serpro69.github.io/ktchn8s/latest)**\n\n
\n\n---\n\n## About\n\nThis project utilizes [Infrastructure as Code](https://en.wikipedia.org/wiki/Infrastructure_as_code) and [GitOps](https://www.weave.works/technologies/gitops) to automate provisioning, operating, and updating self-hosted services in my homelab.\nIt can also be used as a framework to build your own homelab.\n\nIf you encounter an issue or want to contribute a fix or an improvement, please create [a bug issue](https://github.com/serpro69/ktchn8s/issues/new?template=bug.md).\n
If you have a question or want to chat about this project, please create [a new discussion](https://github.com/serpro69/ktchn8s/discussions/new/choose).\n\n## Overview\n\nThis project is still in the experimental stage. This means, among other things, that:\n\n- There might be breaking changes that may require a complete redeployment.\n- A proper upgrade path is planned for the stable release.\n\nMore information can be found in the [roadmap](https://serpro69.github.io/ktchn8s/latest/info/roadmap/).\n\n### Hardware\n\n\n\n- Network:\n - Cisco C1111-8P Router\n - Cisco C3560-GS-8P Switch\n - Eero 6 Router (used as access-point for WiFi at home)\n- Servers:\n - 1 x NAS\n - [Fractal Design Node 804](https://www.fractal-design.com/products/cases/node/node-804/black/) case\n - CWWK/Topton J6413 motherboard\n - CPU: `Intel Celeron J6413`\n - RAM: 2x `16GB DDR4`\n - SSD: 2x `512GB WD RED NVME` in a zfs mirror (OS)\n - HDD: 6x `18TB Seagate Exos` (Storage)\n - 1 ร Lenovo Tiny M70q Gen.3\n - CPU: `Intel Core i5-12400T`\n - RAM: 2x `16GB DDR4`\n - SSD: `256GB NVME`\n - 2 ร Lenovo Tiny M70q Gen.3\n - CPU: `Intel Core i5-12400T`\n - RAM: `16GB DDR4`\n - SSD: `256GB NVME`\n - 2 ร Lenovo Tiny M70q Gen.2\n - CPU: `Intel Core i5-11400T`\n - RAM: `16GB DDR4`\n - SSD: `256GB NVME`\n - 7 ร Lenovo Tiny M720q\n - CPU: `Intel Core i5-8100T`\n - RAM: `16GB`\n - SSD: `512GB NVME`\n - 1 x HP EliteDesk 800 G3 Mini\n - CPU: `Intel Core i5-7500 vPro`\n - RAM: `16GB`\n - SSD: `256GB SATA`\n\n### Features\n\n- [x] Common applications: Gitea, Jellyfin, Paperless...\n- [x] Automated bare metal provisioning with PXE boot\n- [x] Automated Kubernetes installation and management\n- [x] Installing and managing applications using GitOps\n- [x] Automatic rolling upgrade for OS and Kubernetes\n- [ ] Automatically update apps (with approval)\n- [x] Modular architecture, easy to add or remove features/components\n- [x] Automated certificate management\n- [x] Automatically update DNS records for exposed services\n- [ ] VPN (Tailscale or Wireguard)\n- [x] Expose services to the internet securely with [Cloudflare Tunnel](https://www.cloudflare.com/products/tunnel/)\n- [x] CI/CD platform\n- [x] Private container registry\n- [ ] Distributed storage\n- [ ] Support multiple environments (dev, prod)\n- [ ] Monitoring and alerting\n- [ ] Automated backup and restore\n- [x] Single sign-on\n- [x] Infrastructure testing\n\nSome demo videos and screenshots are shown here.\nThey can't capture all the project's features, but they are sufficient to get a concept of it.\n\n| Demo Showcase |\n| :--: |\n| Homepage powered by... [Homepage](https://gethomepage.dev) |\n| [![][homepage-demo]][homepage-demo] |\n| Git server powered by [Gitea](https://gitea.io/en-us) |\n| [![][gitea-demo]][gitea-demo] |\n| Continuous Integration with [Woodpecker CI](https://woodpecker-ci.org/) |\n| [![][woodpecker-demo]][woodpecker-demo] |\n| Continuous Deployment with [ArgoCD](https://argoproj.github.io/cd) |\n| [![][argocd-demo]][argocd-demo] |\n| Identity Management with [Kanidm](https://kanidm.com/) |\n| [![][kanidm-demo]][kanidm-demo] |\n| Monitoring with [Grafana](https://grafana.com/) |\n| [![][grafana-demo]][grafana-demo] |\n\n[homepage-demo]: assets/images/readme/468365600-153d4317-7848-4712-b27f-c89fa30e9dbf.png\n[gitea-demo]: assets/images/readme/460288220-f3775815-6c55-4086-b15a-8e0562e5d6a6.png\n[woodpecker-demo]: assets/images/readme/463804608-70b7e19f-22a3-4d95-aad1-da389d90c53e.png\n[argocd-demo]: assets/images/readme/460288182-bdd91804-2e10-4910-8cf6-afa15e433178.png\n[kanidm-demo]: assets/images/readme/468351420-81c1da79-31ab-4120-b9e8-dc52c94b0fde.png\n[grafana-demo]: assets/images/readme/468351854-a4a53ec5-cb0d-4513-be81-fd646ae66d55.png\n\n## Getting Started\n\n[Deploy on real hardware](https://serpro69.github.io/ktchn8s/latest/installation/production) for production workload.\n\n...or simply:\n\n\n\n โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ\n โ ๐ง โ\n โ โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ โ\n โ โ$ nix develop โ โ\n โ โ$ make ktchn8s โ โ\n โ โ... โ โ\n โ โ โ โ\n โ โ โ โ\n โ โ โ โ\n โ โ โ โ\n โ โ ๐ โ โ\n โ โ โ โ\n โ โ โ โ\n โ โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ โ\n โ โ\n โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ\n โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ\n โญโโโ|โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ|โโโโฎ\n _-' .-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-. --- `-_\n _-'.-.-. .---.-.-.-.-.-.-.-.-.-.-.-.-.-.-.--. .-.-.`-_\n _-'.-.-.-. .---.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-`__`. .-.-.-.`-_\n _-'.-.-.-.-. .-----.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-----. .-.-.-.-.`-_\n _-'.-.-.-.-.-. .---.-. .-------------------------. .-.---. .---.-.-.-.`-_\nโญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ\nโฐโโโ._.โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ._.โโโโฏ\n
\n\n## Roadmap\n\nSee [roadmap](https://serpro69.github.io/ktchn8s/latest/info/roadmap/) and [open issues](https://github.com/serpro69/ktchn8s/issues) for a list of proposed features and known issues.\n\n## Contributing\n\nAny contributions you make are greatly appreciated.\n\nPlease see [contributing guide](https://serpro69.github.io/ktchn8s/latest/info/contributing/) for more information.\n\n## License\n\nCopyright © 2025 - present, [serpro69](https://github.com/serpro69)\n\nDistributed under the MIT License.\nSee [license page](https://serpro69.github.io/ktchn8s/latest/info/license) or [`LICENSE.md`](https://github.com/serpro69/ktchn8s/blob/master/LICENSE.md) file for more information.\n",
"bytes": 8670,
"sha": "3f518ef0e4f780c50bf76298e154a8f5028d2e487c51535b8879f93f5584a943",
"repo_slug": "serpro69/ktchn8s",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/skl_serpro69_ktchn8s_development_development_8940f089/readme"
}