Homelab Documentation

Welcome to the microLab!

My goal is to have a homelab with critical services being highly available, important services being self-healing, and optional services mostly available, while maintaining a small footprint and low power consumption. Here's a photo of the current lab setup.

This repo exists as part of the billv-ca/homelab-* series of repositories containing IaC and documentation for my homelab.

This repo contains documentation for the homelab-* series of repositories. See also:

• homelab-atlantis-k3s-base-services
• homelab-atlantis-k3s-services

⚙️ Hardware

IoT Devices

A plethora of different devices all integrated with HomeAssistant. Mostly TP-Link for smart switches and outlets.

Home Assistant Voice Preview Edition (x4)

🕸️ Network Infrastructure

Switches

• TL-SG1016PE (Facebook Marketplace $75 unopened)
• Proxmox Cluster 2.5G
• Netgear GS105

Access Points

• 3x TP-Link Omada EAP-650

Zigbee

• SMLIGHT SLZB-06

Router

• pfSense pfSense is a free and open source firewall and router that also features unified threat management, load balancing, multi WAN, and more.

  • HP Elitedesk 800 G3 Mini (35W) - Microcad.ca $94
    • Intel® Core™ i5-6500T CPU @ 2.50GHz
    • 8GB DDR4
    • 512GB NVME
    • 1Gbe on board
    • 2.5Gbe m.2 NIC

Network Diagram

graph
    ONT[*ONT* 💿] --> ROUTER[*Pfsense* 💻↔️🌐]
    ROUTER --> MAINSWITCH[*TL-SG1016PE* 💻🔗💻]
    MAINSWITCH --> VLAN0[**LAN** 🌐✂️🖥️]
    MAINSWITCH --> VLAN2[**IOT** 📡🌐✂️🖥️]
    MAINSWITCH --> VLAN1[**Main** 📡🌐✂️🖥️]
    MAINSWITCH --> VLAN4[**Guest** 📡🌐✂️🖥️]
    MAINSWITCH --> VLAN3[**Homelab** 🌐✂️🖥️]
    VLAN0 --> PCs[**PCs** ⌨️🖱️💻]
    VLAN1 --> AP[3 x *EAP-650* 🛜]
    AP -.-> WLDEV[**Wireless Devices** 📡]
    VLAN4 --> AP
    VLAN2 --> AP
    VLAN3 --> HLSW[*2.5G Switch* 💻🔗💻]
    HLSW --> PM[**Proxmox Nodes** 💻]
    VLAN3 --> ZIGBEE[**SMLIGHT SLZB-06** 🛜]
    ZIGBEE -.-> ZBDEV[**Zigbee Devices** 📡]
    VLAN2 --> NGSW[*Netgear GS105*]
    NGSW --> WSD[**Wired IoT Devices**]

Loading

---

🧠 Compute Nodes

• HP Elitedesk 800 G4 Mini (35W) - Microcad.ca $116

  • Intel® Core™ i5-8500T CPU @ 2.10GHz
  • 16GB DDR4
  • 256GB NVME
  • 1TB SATA III SSD
  • 1Gbe on board - Used for AMT
  • m.2 -> oculink adapter
  • Minisforum DEG1 eGPU dock
  • ASUS AMD 7800XT
  • FSP VITA 750W power supply
  • 2.5Gbe m.2 NIC

• HP Elitedesk 800 G3 Mini (35W) - Microcad.ca $94

  • Intel® Core™ i5-6500T CPU @ 2.50GHz
  • 16GB DDR4
  • 256GB NVME
  • 1TB SATA III SSD
  • 1Gbe on board - Used for AMT
  • 2.5Gbe m.2 NIC

• HP Elitedesk 800 G3 Mini (65W) - Microcad.ca $94

  • Intel® Core™ i5-6500 CPU @ 3.20GHz
  • 24GB DDR4
  • 256GB NVME
  • 1TB SATA III SSD
  • 1Gbe on board - Used for AMT
  • 2.5Gbe m.2 NIC
  • TERRAMASTER D4-320U 4 bay 1U DAS enclosure

🔌 Power Supplies

• APC Back-UPS ES 350VA

---

🖥️ Software

rocm-wyoming-whisper

rocm-wyoming-whisper A docker image and a few lines of python to use OpenAI whisper with Rhasspy and/or Home Assistant on AMD GPUs with ROCm.

Used with a HomeAssistant voice pipeline for insanely fast speech to text.

🐧 Proxmox VE

Proxmox is a complete, open-source server management platform for enterprise virtualization. It tightly integrates the KVM hypervisor and Linux Containers (LXC), software-defined storage and networking functionality, on a single platform. With the integrated web-based user interface you can manage VMs and containers, high availability for clusters, or the integrated disaster recovery tools with ease.

🔑 Integrated with Authentik

Virtual Machines

• Kubernetes
  • k3s-0
• Home Assistant

🏠 Home Assistant

Home Assistant is open source home automation that puts local control and privacy first. Powered by a worldwide community of tinkerers and DIY enthusiasts.

Add Ons

• File Editor
• Music Assistant
• Mosquitto
• Zigbee2MQTT
• Piper
• Whisper

🐳 K3s Kubernetes

K3s is lightweight Kubernetes. Easy to install, half the memory, all in a binary of less than 100 MB.

Kubernetes Nodes

• VMs
  • k8s-0
• Baremetal
  • node-1
  • node-2

🌍 Kubernetes Services

Service	Category	Description	Authentik Integration
Atlantis	IaC Deployment	Atlantis is Terraform Pull Request Automation.	✅
Authentik	Identity	Authentik is a self-hosted, open-source identity provider.
Cert Manager	Network	cert-manager is a powerful and extensible X.509 certificate controller for Kubernetes and OpenShift workloads. It will obtain certificates from a variety of Issuers, both popular public Issuers as well as private Issuers, and ensure the certificates are valid and up-to-date, and will attempt to renew certificates at a configured time before expiry.
Crafty Controller	Games	Crafty Controller is a cross-platform Minecraft server control platform that you control from your web browser.
Grafana	Monitoring	With Grafana you can create, explore, and share all of your data through beautiful, flexible dashboards.	✅
Headlamp	System Tools	Headlamp is an easy-to-use and extensible Kubernetes web UI.	✅
Longhorn	Storage	Longhorn provides cloud-native persistent block storage.	✅
Mealie	Recipe Storage	Mealie is an intuitive recipe management app.	✅
Meshcentral	System Tools	Meshcentral is an open source, multi-platform, self-hosted, feature packed web site for remote device management with support for Intel AMT.	✅
MetalLB	Network	MetalLB is a load-balancer for bare-metal Kubernetes.
OCIS	File Sync	Welcome to oCIS, the modern file-sync and share platform, which is based on our knowledge and experience with the PHP based ownCloud server.	✅
Ollama	AI	Ollama lets you run large language models locally.
Omada Software Controller	Network	Omada software controller manages Omada APs.
Open WebUI	AI	Open WebUI is an extensible, self-hosted AI interface that adapts to your workflow, all while operating entirely offline.	✅
Orca Slicer	3d Printing	Orca Slicer: an open source Next-Gen Slicing Software for Precision 3D Prints	✅
Pi-hole	Network	Pi-hole offers network-wide ad protection.	✅
Prometheus	Monitoring	Prometheus. Monitor your applications, systems, and services with the leading open source monitoring solution. Instrument, collect, store, and query your metrics for alerting, dashboarding, and other use cases.
ROCm k8s-device-plugin	System Plugin	ROCm k8s-device-plugin enables AMD GPU registration in Kubernetes clusters.
Traefik	Network	Traefik is a leading modern open source reverse proxy and ingress controller that makes deploying services and APIs easy. Traefik integrates with your existing ...	✅
Trilium	Notes	Trilium is an open-source knowledge base and note-taking application	✅
Wireguard UI	System Tools	Wireguard UI is a web user interface to manage your WireGuard setup.	✅
Wireguard	Network	Wireguard: fast, modern, secure VPN tunnel. WireGuard® is an extremely simple yet fast and modern VPN that utilizes state-of-the-art cryptography.

3D print(er)s

3D models used in my lab

• 1U rackmount for HP Elitedesk G3 mini and newer (Thanks Spekkie3D)
• elietedesk 800 g3 mini youyeetoo 2.5g nic i225v

3D printer used in my lab

• Elegoo Centauri Carbon