🏠 Homelab Kubernetes

A self-hosted Kubernetes environment for homelab computing, gaming, and learning DevOps.

---

What's Here

Component	Description
k3s Cluster	Lightweight Kubernetes on Debian
Minecraft Server	Modded Java Edition with friends
Headless WOL	Remote boot/maintain a gaming PC via homelab
VPN Access	Tailscale for secure remote access

---

Architecture

flowchart LR
    subgraph Remote
        Device[Steam Deck / Phone / Laptop]
    end

    subgraph Homelab
        HomelabNode[Homelab Server]
        K8s[k3s Cluster]
    end

    subgraph MainPC
        Linux[Pop!_OS]
        Windows[Windows]
    end

    Device -- Tailscale --> HomelabNode
    HomelabNode -- WOL --> Linux
    HomelabNode -- SSH --> Linux
    Linux -- bootctl --> Windows

Loading

---

Quick Start

# Minecraft server
kubectl apply -f apps/minecraft-server/deployment/

# Headless WOL (see docs/guides/headless-wol-guide.md)
wol-pc status

---

📁 Structure

homelab-k8s/
├── apps/              # Kubernetes manifests
│   └── minecraft-server/
├── scripts/           # Helper scripts (wol-pc, etc.)
├── docs/
│   ├── guides/       # How-to tutorials
│   ├── howto/        # Technical reference
│   └── plans/        # Internal runbooks
└── infrastructure/   # Core configs

---

📖 Documentation

• Guides — Step-by-step tutorials
• Headless WOL — Remote boot gaming PC
• k3s Setup — Cluster configuration

---

🔧 Getting Started

See docs/guides/k3s-setup.md for cluster setup.