Skip to main content

Getting Started

This guide tracks the homelab.kubernerdes.com repo — a lab/demo environment showcasing SUSE infrastructure and cloud-native software, along with guidance on how to deploy it.

Deployment Modes​

The environment supports three deployment modes, selected via ENVIRONMENT:

ENVIRONMENTCIDRPurpose
homelab10.10.12.0/22Supernet for the lab — shared infra services (DHCP, DNS, PXE, etc.)
enclave10.10.13.0/24Air-gapped deployment using SUSE Prime and Hauler
community10.10.14.0/24Deployment using community bits
prime10.10.15.0/24Deployment using bits from the SUSE Prime registry/repo

Tech Stack​

  • SUSE Virtualization (Harvester)
  • SUSE Rancher Manager
  • SUSE Security (NeuVector)
  • SUSE Observability (StackState)
  • SUSE Linux Enterprise (SLE/SLES) / SUSE Linux Enterprise Micro (SL-Micro)
  • SUSE RKE2 (K3s when needed — not yet supported for the SUSE Security install)
  • RGS Hauler
  • Harbor

Guide Structure​

  • Day 0 - Plan — planning and architecture
  • Day 1 - Build — install Harvester, Rancher Manager, the Apps cluster (with Security), and Observability
  • Day 2 - Operate — backups, RBAC, and ongoing operations
  • Deep Dives — product overview and background reading (air-gapping, load balancing, security model)