HomeOps

Infrastructure as Code repository for home infrastructure management.

homeops/
├── talos/              # Talos Kubernetes cluster configurations
│   └── talos1018/      # Cluster-specific config and patches
├── kubernetes/         # Flux CD GitOps manifests
│   ├── apps/           # Application deployments
│   │   └── talos1018/  # Cluster applications
│   ├── infrastructure/ # Infrastructure components
│   │   └── talos1018/
│   │       ├── core/   # Core components (CNI, cert-manager)
│   │       └── storage/ # Storage layer (Longhorn)
│   ├── clusters/       # Flux configurations
│   │   └── talos1018/
│   │       ├── flux-system/
│   │       ├── infrastructure.yaml
│   │       └── apps.yaml
│   └── components/     # Shared Kustomize components
├── scripts/            # Automation and validation scripts
├── docs/               # Documentation and assets
└── .github/            # CI/CD workflows

A 3-node Kubernetes cluster running on Talos Linux. For detailed setup and configuration, see talos/talos1018/README.md.

• Control plane: 3 nodes
• Network: Cilium CNI (native routing) with L2 announcements and Gateway API
• Dual-stack, IPv6-primary (ULA fd00:1018:0:5:10:18:6:90-93, IPv4 10.18.6.90-93)

Layered architecture with minimal dependencies:

Core (no dependencies):

• Cilium CNI (native routing) with L2 announcements and Gateway API (HTTPRoutes for all apps)
• cert-manager with Let's Encrypt

Storage (depends on core):

• Longhorn with S3 backups to Cloudflare R2

Applications (depends on core):

• Deploy in parallel
• Storage-dependent apps wait automatically via Kubernetes

GitOps with Flux CD. See kubernetes/README.md for details.

• Continuous deployment via Flux CD
• Secret management with SOPS + age
• Automated validation via GitHub Actions

• talosctl
• kubectl
• helm
• flux CLI
• sops (for secret management)

1. Clone the repository:

git clone https://github.com/fmurodov/homeops.git
cd homeops

2. Navigate to the desired project directory and follow the project-specific README instructions.

To automatically validate configs before committing:

cp scripts/pre-commit .git/hooks/pre-commit

This will run ./scripts/validate.sh before each commit. To bypass: git commit --no-verify