Main page

Welcome to the rpi-homelab documentation.

My homelab is mainly focused on running single node k8s cluster hosting opensource apps like Home Assistant, Zigbee2MQTT, OpenCloud, ArgoCD, SemaphoreUI e.t.c.

Cluster is running on Raspberry Pi 5. K3s is used instead of installing full Kubernetes from scratch, providing a lightweight but fully featured control plane for homelab services.

Infra is provisioned "as Code" by opentofu (terraform fork), hosts managing is automated by ansible.

Hosts inventory overview

• RPI5 - k8s custer

Raspberry Pi 5 (8 GB RAM) + SSD HAT + Sonoff Zigbee USB3.0 dongle

• RPI02W - 3d printer management node

Raspberry Pi Zero 2W (512 MB RAM) + RaspberryPI Camera 3

• WYSE - DNS + NFS server

DELL WYSE 3040 (2 GB RAM) + 1TB HDD

• Other workstations

PC + Laptop

Project repositories

• rpi-homelab/infra - Opentofu configs

• rpi-homelab/kubernetes-manifests - Kubernetes apps YAML manifests (Deployments, Services, HTTPRoutes, etc.) per app directory. Primary source for manifest-based apps on self hosted ArgoCD.

• rpi-homelab/ansible - Ansible inventory/roles/playbooks etc. Source for self-hsoted SemaphoreUI

• rpi-homelab/configs - (private repo) - Application configuration e.g. ConfigMaps, Secrets etc. Optional source for ArgoCD.

• rpi-homelab/docs - (private repo) - Project documentation.