Skip to content

Hyperoot Homelab

Welcome to a single-node Kubernetes platform built to make infrastructure understandable, reproducible, and pleasant to operate. Talos Linux provides the immutable host, Flux continuously reconciles this repository, and every active application sits on a small set of shared platform services.

  • Understand the platform

    Start with the architecture overview to see how Git, Flux, networking, secrets, and workloads fit together.

  • Recreate the host

    Follow the platform setup to understand the Talos installation, NVIDIA host support, and local storage foundation.

  • Explore what is running

    Browse applications and platform services, with status, dependencies, configuration paths, and ownership on each page.

  • Learn the GitOps model

    Read the GitOps overview before changing manifests or adding a service.

  • Operate the cluster

    Use runbooks for repeatable bootstrap, recovery, and credential-management procedures.

Platform at a glance

flowchart TB
    Git[GitHub repository] --> Flux[Flux CD]
    Flux --> Controllers[Infrastructure controllers]
    Controllers --> Configs[Infrastructure configuration]
    Configs --> Apps[Homepage, Linkding, and Postiz]

    LAN[Home network] --> MetalLB[MetalLB VIP]
    MetalLB --> Traefik[Traefik ingress]
    Traefik --> Apps

    Internet[Internet] --> Cloudflare[Cloudflare edge]
    Cloudflare --> Cloudflared[Cloudflared tunnel]
    Cloudflared --> Linkding[Linkding]

    Vault[Vault] --> ESO[External Secrets]
    ESO --> Cloudflared
    ESO --> Monitoring[Prometheus and Grafana]
    ESO --> Postiz

    Talos[Talos XFS user volume] --> LocalPath[Local Path Provisioner]
    LocalPath --> CNPG[CloudNativePG]
    LocalPath --> Monitoring
    LocalPath --> Postiz

Current state

Area Status Components
Platform Active Talos Linux, Kubernetes, Flux CD, NVIDIA GPU Operator, local storage
Networking Active MetalLB, Traefik, Cloudflared
Secrets Active Vault, External Secrets Operator
Applications Active Homepage, Linkding, Postiz
Databases Active CloudNativePG hosts the Postiz and Temporal databases
Monitoring Active Prometheus, Alertmanager, Grafana, and cluster exporters

How to read these docs

  1. Architecture explains relationships across the whole platform.
  2. Platform setup explains the Talos host foundation.
  3. GitOps explains how repository changes become live state.
  4. Applications documents user-facing workloads.
  5. Services documents shared infrastructure components.
  6. Runbooks provides commands for operational procedures.

Source of truth

These pages explain the current system. Flux manifests under gitops/ and Terraform under iac/ remain the operational source of truth.