This repository documents and maintains the configuration, deployment manifests, and automation scripts used to run my homelab environment.
It’s built around Kubernetes, TrueNAS, and Proxmox, and serves as a reproducible, version-controlled record of how my infrastructure evolves.
My homelab combines virtualization, storage, and container orchestration into a single, cohesive ecosystem:
| Layer | Technology | Purpose |
|---|---|---|
| Compute & Virtualization | Proxmox VE | Hosts virtual machines, LXC containers, and manages hardware resources. |
| Storage | TrueNAS SCALE | Provides network storage via NFS/SMB and ZFS datasets used by Kubernetes. |
| Orchestration | Kubernetes - k3s | Runs containerized workloads and manages networking, ingress, and storage. |
All configurations are declarative (YAML, Helm values, etc.) and stored in this repository to ensure repeatability and version tracking.
- Base hypervisor managing all VMs and LXC containers.
- Provides compute resources for the Kubernetes cluster.
-
Centralized storage system for persistent volumes and backups.
-
Exposes:
- NFS shares for Kubernetes PersistentVolumeClaims (PVCs)
-
Periodic snapshot and replication policies ensure data resilience.
- Deployed on top of VMs managed by Proxmox.
- Uses Helm for deploying services and ingress controllers (e.g., Traefik, cert-manager).
- Persistent storage backed by TrueNAS via NFS.
- Workloads include:
- Internal services (monitoring, dashboards, automation)
- Media stack (e.g., Jellyfin, Sonarr, Radarr)
- Reverse proxy and certificate management
- GitOps and CI/CD tooling (future plans)
.
├── manifests/ # Kubernetes manifests and Helm values
│ ├── traefik/ # Ingress controller configuration
│ ├── certmanager/ # cert-manager and issuer definitions
│ ├── apps/ # Workloads and internal services
│ └── storage/ # PVCs, NFS storage classes, etc.
├── proxmox/ # Proxmox VM/LXC definitions, cloud-init templates
├── truenas/ # Storage configuration notes and export setup
├── scripts/ # Helper scripts for automation and maintenance
└── docs/ # Additional documentation and setup notes
Each directory contains modular configuration components and documentation explaining the setup or deployment process for that layer.
This repository does not include any sensitive credentials or API tokens.
All secrets are stored separately (e.g., in SealedSecrets, Vault, or environment variables) and referenced as Kubernetes resources.
When contributing or restoring configurations, ensure you never commit files containing passwords, tokens, or SSH keys.
| Tool | Purpose |
|---|---|
| Helm | Package management for Kubernetes deployments |
| kubectl | CLI management of Kubernetes resources |
| Ansible | Automate host configuration and updates |
- Snapshots handled by TrueNAS for critical datasets.
- Configuration backup through Git commits and remote repository sync.
- Certificates automatically renewed via cert-manager and Cloudflare DNS challenge.
- Maintain a clean, modular, and reproducible homelab.
- Learn and apply DevOps practices (GitOps, IaC, container orchestration).
- Self-host services for media, automation, and monitoring.
- Experiment with scaling, high availability, and distributed storage.
- Add ArgoCD for GitOps automation
- Integrate Prometheus + Grafana for monitoring
- Deploy Longhorn or OpenEBS for distributed storage
Kevin (@holden093)
Homelab enthusiast • Linux user • Automation nerd
If you’re building something similar or want to share ideas, feel free to open an issue or discussion!
This repository is licensed under the MIT License.
Feel free to fork, adapt, and use it for your own homelab.