Home

Awesome

<div align="center">

Kashall's Home Operations

Discord   Talos   Kubernetes   Renovate

Age-Days    Uptime-Days    Active-Alerts    Node-Count    Pod-Count    CPU-Usage    Power-Usage

</div>

What is this?

This is the repository I use to version control my kubernetes clusters I deploy and maintain at home. I currently use Talos to provide a secure, minimal and immutable environment for Kubernetes. Previous iterations of this repository relied on Debian-based Operating Systems which can lead unwanted changes in the base system.

How did you do this?

Thanks to onedr0p, there is the cluster template that allows you to easily get started with your own kubernetes cluster at home. You don't need to have multiple computers or a fancy setup to get one working.

If you're interested, you can also join the community Discord: Home Operations. Several people are involved daily and it makes for some interesting conversations.

Directory Helper

This repository uses the following layout for Kubernetes.

📁 kubernetes
└── 📁 {cluster}
   ├── 📁 apps # Per-cluster application-specific configurations.
   ├── 📁 bootstrap # Flux & Talos configurations for setting up the cluster.
   ├── 📁 flux # Flux configuration, application repositories and more.
   ├── 📝 kubeconfig # Kubernetes Certificate
   └── 📝 talosconfig # Talos Certificate

☁️ Cloud Dependencies

While most of my infrastructure and workloads are self-hosted I do rely upon the cloud for certain key parts of my setup. This saves me from having to worry about two things. (1) Dealing with chicken/egg scenarios and (2) services I critically need whether my cluster is online or not.

ServiceUseCost
1PasswordSecrets with External Secrets~$55/yr
CloudflareDomains, Workers, Pages, and R2~$30/yr
GCPVoice interactions with Home Assistant over Google AssistantFree
GitHubHosting this repository and continuous integration/deploymentsFree
Let's EncryptIssuing SSL Certificates with Cert ManagerFree
MigaduEmail Hosting~$20/yr
Pulumi CloudResource state managementFree
PushoverKubernetes Alerts and application notificationsFree
UniFi Site ManagerUniFi External Access ManagementFree
Total: ~$10/mo

💻 Networking

<details> <summary>Click to see a high-level network diagram</summary> <img src="https://raw.githubusercontent.com/kashalls/home-cluster/main/.github/assets/network-topology.png" align="center" width="600px" alt="networking"/> </details>

🌐 DNS

UniFi released a new feature update with UniFi routers that allow you to create custom dns records to be served to the whole network. I wroteExternal DNS Unifi Webhook to allow External DNS to gather service and ingress hosts from my clusters and deploy the records without any extra local resolvers.


🔧 Hardware

<details> <summary>Click to see the rack!</summary> Updated 05/25/2024 <img src="https://owo.whats-th.is/2drDDRN.jpg" align="center" width="200px" alt="rack"/> </details>
DeviceCountOS Disk SizeData Disk SizeRamOperating SystemPurpose
UXG-Max1---UniFi OSRouter
UCK-G2-Plus1-250 GB HDD3GBUniFi OSUniFi Management
US-24-G11----Core Switch
U6-LR1----Office AP
UAP-AC-Pro1----Dining Room AP
USP-PDU-Pro1----Rack PDU
Raspberry Pi 43256GB SSD-8GBTalosRaspberry Cluster
Lenovo ThinkCentre M9006256GB SSD1TB NVMe (rook-ceph)16GBTalosKubernetes Nodes
Fran12x1TB SSD5x8TB (raidz2)64GBDebianStorage Cluster
Raspberry Pi 3132GB (SD)-4GB-Network KVM
APC Back-Ups 15001----UPS

⭐ Stargazers

<div align="center">

Star History Chart

</div>

Inspiration

Thanks to all the people who donate their time to the Home Operations community.

Special thanks to: ᗪєνιη ᗷυнʟ, Bᴇʀɴᴅ Sᴄʜᴏʀɢᴇʀs, and Toboshii Nakama for their assistance.

Check out kubesearch.dev to see what other users are running in their kubernetes home labs!