homelab

GitOps-driven homelab. Self-hosted. Automated. Encrypted.

Work in progress

This documentation is still being written and may be incomplete or out of date.

---

About

Single source of truth for my homelab — every piece of infrastructure declared as code, version-controlled, and automatically applied.

• Kubernetes workloads

  Managed by ArgoCD via GitOps. Push to master, the cluster syncs itself.

• Server provisioning

  k3s cluster setup and server management handled by Ansible.

• Infrastructure

  Cloudflare DNS, tunnels, and more via Terraform.

• Secrets

  Encrypted at rest with SOPS. Never committed in plaintext.

---

Explore

• Architecture

  ---

  High-level design, cluster servers, and networking.

  Overview

• Services

  ---

  All running services across every namespace.

  Services

• Kubernetes

  ---

  ArgoCD GitOps, namespaces, and how to add a new app.

  GitOps with ArgoCD

• Ansible

  ---

  Server provisioning, k3s cluster management, and playbooks.

  Ansible docs

• Terraform

  ---

  Cloudflare DNS, tunnels, and external infrastructure.

  Terraform docs

• Secrets

  ---

  SOPS encryption rules and secret management patterns.

  Secrets

• Runbooks

  ---

  Step-by-step operational procedures.

  Runbooks