Homelab Infrastructure

A modern, Kubernetes-based homelab infrastructure built with Talos Linux, ArgoCD, and other cloud-native tools.

🏗️ Architecture

This homelab is built on a foundation of modern infrastructure tools:

• Talos Linux: A secure, immutable, and minimal Linux distribution designed for running Kubernetes
• Kubernetes: The container orchestration platform
• ArgoCD: GitOps continuous delivery tool
• Cilium: Container networking and security
• 1Password: Secrets management
• SOPS: Secrets encryption

🚀 Getting Started

Prerequisites

• Talos Linux
• kubectl
• sops
• just command runner
• direnv (optional, but recommended)

Initial Setup

1. Clone this repository:

   git clone https://github.com/smauermann/homelab.git
   cd homelab

2. Copy the example environment file and configure it:

   cp example.envrc .envrc
   # Edit .envrc with your configuration

3. Generate Talos secrets:

   just gen-secrets

4. Generate Talos configuration:

   just gen-config

5. Apply the configuration to your nodes:

   just apply-all

6. Bootstrap the cluster:

   just bootstrap $FIRST_NODE

7. Deploy the base applications (Cilium, 1Password, ArgoCD):

   just bootstrap-apps

📁 Project Structure

.
├── bootstrap/           # Initial setup before ArgoCD takes over
├── infra/               # Adjacent infrastructure like S3 buckets
├── kubernetes/          # Kubernetes manifests
│   ├── applications/    # Application workloads
│   └── infrastructure/  # Core infrastructure components
├── talos/               # Talos Linux configurations
└── hack/                # Utility scripts

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.