Skip to content

thdxg/homelab

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

71 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kubernetes Homelab

Two-node k3s cluster on Raspberry Pi 5s, with Cilium as CNI, kube-proxy replacement, and Gateway API implementation. Bootstrap and operations are driven by mise tasks.

Nodes

name role machine RAM Disk
node-1 master Raspberry Pi 5 8GB 0.5TB
node-2 worker Raspberry Pi 5 8GB 1TB

Software

  • OS: Ubuntu Server 26.04
  • Kubernetes: k3s v1.35.4 (Flannel, kube-proxy, servicelb, and Traefik disabled)
  • CNI: Cilium 1.19.3 (kube-proxy replacement, Gateway API, L2 announcements, Hubble)
  • Networking: Tailscale for remote access
  • Tooling: mise, kubectl, cilium-cli (versions pinned in mise.toml)

Project Layout

  • mise.toml — root mise config; declares the monorepo, pins tools (e.g. kubectl), and stores per-node local and Tailscale IPs as env vars.
  • bootstrap/ — initial cluster setup: OS tweaks (AppArmor), k3s install on both nodes, kubeconfig fetch, and Cilium install.

Requirements

The setup assumes:

  1. Two nodes running Ubuntu Server 26.04, reachable as node-1 and node-2
  2. Password-less SSH access to both nodes
  3. Local and Tailscale IPs for each node set in mise.toml
  4. mise installed on the operator machine

About

Kubernetes Homelab

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors