https://github.com/eleboucher/homelab
https://github.com/eleboucher/homelab
homelab k8s-at-home kubernetes kubesearch
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/eleboucher/homelab
- Owner: eleboucher
- License: apache-2.0
- Created: 2025-12-14T18:58:49.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-03-27T00:03:22.000Z (2 months ago)
- Last Synced: 2026-03-27T06:48:38.815Z (2 months ago)
- Topics: homelab, k8s-at-home, kubernetes, kubesearch
- Language: YAML
- Homepage:
- Size: 2.19 MB
- Stars: 11
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# homelab K8s
### 🏠 A GitOps-managed Homelab
_Powered by [Talos](https://talos.dev), [Flux](https://fluxcd.io), and [Kubernetes](https://kubernetes.io)_
[](https://talos.dev)
[](https://kubernetes.io)
[](https://fluxcd.io)
---
## 📖 Overview
This repository hosts the Infrastructure as Code (IaC) for my Kubernetes homelab. It runs a media server stack, home automation, and observability infrastructure.
The cluster is built on **Talos Linux**, an immutable and minimal OS, and managed via **GitOps** principles using **Flux**. Changes pushed to this repository are automatically reconciled in the cluster.
---
## ⚙️ Hardware
My cluster is a hybrid setup running on bare metal and virtualized nodes.
| Node | OS | Hardware | Specs | Role | Storage |
| :--- | :--- | :--- | :--- | :--- | :--- |
| **kharkiv** | Talos Linux | Intel i5 12th Gen | 8C / 16T / 32GB | `control-plane` | |
| **le-havre**| Talos Linux | Intel N150 | 4C / 4T / 32GB | `worker` | USB HDD (`/mnt/media`) |
---
## 🧩 Core Components
| Component | Description | Namespace |
| :--- | :--- | :--- |
| **[Cilium](https://cilium.io/)** | CNI, Network Policies, and Load Balancing. | `kube-system` |
| **[Cert-Manager](https://cert-manager.io/)** | Automates Let's Encrypt SSL certificates. | `cert-manager` |
| **[External Secrets](https://external-secrets.io/)** | Syncs secrets from 1Password into the cluster. | `security` |
| **[Gateway API](https://gateway-api.sigs.k8s.io/)** | Modern ingress management via **Envoy Gateway**. | `network` |
| **[Longhorn](https://longhorn.io/)** | Distributed block storage for persistent volumes. | `longhorn-system` |
---
## 🚀 Services & Applications
Key user-facing applications running on the cluster.
| Category | Applications |
| :--- | :--- |
| **Media** | [Jellyfin](https://jellyfin.org/), [Sonarr](https://sonarr.tv/), [Radarr](https://radarr.video/), [Bazarr](https://www.bazarr.media/), [Prowlarr](https://prowlarr.com), [Seerr](https://github.com/seerr-team/seerr) |
| **Observability** | [Grafana](https://grafana.com/), [Prometheus](https://prometheus.io/), [VictoriaLogs](https://docs.victoriametrics.com/victorialogs/), [Gatus](https://gatus.io)|
| **IOT** | [Home Assistant](https://www.home-assistant.io/) |
---
Huge thanks to [@onedr0p](https://github.com/onedr0p) and the amazing [Home Operations](https://discord.gg/home-operations) Discord community for their knowledge and support. If you're looking for inspiration, check out [kubesearch.dev](https://kubesearch.dev) to discover how others are deploying applications in their homelabs.