idcrook/kubernetes-homespun

Build a kubernetes home cluster (on SBC like Raspberry Pis)

An in-home kubernetes cluster network (serves to Internet)

Apps and services deployed via kubernetes:

• phant - IoT data logging
  • https://data.crookster.org
• lighttpd - Static webpage server
  • https://www.crookster.org
  • https://party.crookster.org
• miniflux - RSS Feed aggregator and syncing
  • https://miniflux.crookster.org

High-level

• Raspberry Pi-s
• kubernetes via k3s
  • "external" NFS server for persistent storage
  • "external" postgresql server for database
• traefik v2.10 for ingress
  • includes Let's Encrypt (TLS certificates) and wildcard DNS support

Hardware:

• PINE64 ROCK64 (1GB): Diet Pi (buster) : k3s control plane node
• Raspberry Pi 4 B (4GB): Raspberry Pi OS (arm64 bullseye) : k3s worker node
  • "external" postgresql DB, USB thumb drive for db storage
• NAS : "external" NFS server
• Raspberry Pi 4 B (4GB): Running BirdNET.Pi on PoE connection

Use "external" postgresql db

• miniflux
• freshrss
• wikijs

Offline services (there may be others)

• Wiki.js - A wiki app built on NodeJS
  • https://wiki.idcrook.dev
• FreshRSS - Another RSS Feed aggregator and syncing
  • https://freshrss.crookster.org
• Bird Net Pi - A realtime acoustic bird classification system
  • https://birdnetpi.idcrook.dev

---

Get it done

• BUILD.md, RUN.md - Start kubernetes by installing k3s...

• circa 2018 Original Blog post and CLUSTER.md - previous kubernetes cluster setup used kubeadm