Services

Everything that runs in the homelab, and where. The details of each app are in the linked directories and docs; this page is the overview.

Services needed to run or fix the cluster (DNS, monitoring, the network controller, remote access) run outside Kubernetes on purpose (ADR 0014). Everything else runs in the cluster. All addresses are under magelssen.io and go through the Envoy Gateway at 192.168.30.200, also for services outside the cluster.

scripts/check-services.py (a pre-commit hook) fails when a directory in kubernetes/apps/ is missing from this page, or this page names one that does not exist. The rows for things outside Kubernetes are kept up to date by hand.

In Kubernetes

ServiceWhat it is forAddressDataIn Git
JellyfinWatching movies and series, with Quick Sync transcodingjellyfin.Config on local-path, media in DukesArchiveskubernetes/apps/media
Radarr, SonarrFinding and importing movies and seriesradarr., sonarr.Config on local-path, media in DukesArchiveskubernetes/apps/media
ProwlarrIndexers for Radarr and Sonarrprowlarr.Config on local-pathkubernetes/apps/media
qBittorrentDownloads, through NordVPN (gluetun sidecar)qbittorrent.Config on local-path, files in DukesArchives/downloadskubernetes/apps/media
AudiobookshelfAudiobooksaudiobooks.Config on local-path, books in DukesArchives/audiobookskubernetes/apps/media
ImmichPhotos and videos from the phonesimmich.AnorLondo/immich, BlightTown/immich, Postgres (CloudNativePG) on local-pathkubernetes/apps/immich
Home AssistantSmart homeha.BlightTown/home-assistantkubernetes/apps/home-assistant
HomarrStart page with links to everythingdashboard.SQLite on local-pathkubernetes/apps/homarr
restic rest-serverBackups of the laptopsrestic.Catacombs/backups/restickubernetes/apps/restic
Grafana, Prometheus, AlertmanagerMetrics, dashboards, and alerts to Telegram and Gmailgrafana.local-pathkubernetes/infrastructure/kube-prometheus-stack
podinfoSmall test app for the Gateway and Fluxpodinfo.Nonekubernetes/apps/podinfo

Outside Kubernetes

Set up by hand until Terraform and Ansible cover Proxmox (#104). The cluster only has a route to them: an Envoy Gateway Backend and an HTTPRoute.

ServiceWhat it is forRuns onAddressDataIn Git
Pi-holeDNS for the house, and the local records for *.magelssen.io (ADR 0012)LXC 104pihole.LXC diskRoute only: kubernetes/apps/pihole
Uptime KumaChecks the services from outside the cluster (docs/services/uptime-kuma.md)LXC 101uptime-kuma., or 192.168.20.10:3001 when the cluster is downLXC diskRoute only: kubernetes/apps/uptime-kuma
TailscaleRemote access to the LAN from outsideLXC 103NoneLXC diskNothing
Omada controllerManages the router, the switch and the access pointTrueNAS appomada.Catacombs/data (moving to UndeadParish/omada)Route only: kubernetes/apps/omada
TrueNAS SCALENAS: NFS and SMB shares, snapshots, the pool Firelink (docs/architecture/storage.md)VM 100truenas.Pool FirelinkRoute only: kubernetes/apps/truenas
Proxmox VEHypervisor for TrueNAS and the LXCspve (bare metal)proxmox.local, local-lvmRoute only: kubernetes/apps/proxmox

Proxmox guests

Every VM and LXC on pve, so nothing there is unexplained.

IDNameKindPurpose
100TrueNASVMNAS
101uptime-kumaLXCUptime Kuma
103tailscaleLXCTailscale
104PiHoleLXCPi-hole
9000ubuntu-2404-templateVM templateUbuntu 24.04 for quickly creating VMs, for example test clusters

Platform

The cluster add-ons that the services above use (Flux, Envoy Gateway, MetalLB, cert-manager, External Secrets, CloudNativePG, local-path, the Intel GPU plugin and others) are listed in kubernetes/README.md. Why each was chosen is in the technology choices and the decision records.