Home cluster

Features • Get started • Documentation • Roadmap

This project utilizes Infrastructure as Code and GitOps to automate provisioning, operating, and updating self-hosted services in our home cluster.

Overview

Project status: BETA

Features

• Automated bare metal provisioning with Ansible
• Automated Kubernetes installation and management
• Installing and managing applications using GitOps
• Automatically update apps (with approval)
• Modular architecture, easy to add or remove features/components
• Automated certificate management
• Automatically update DNS records for exposed services
• CI/CD platform
• Git server
• Private container registry
• Support multiple environments (development and production)
• Monitoring and alerting
• Automated offsite backups
• Single sign-on

Tech stack

Logo	Name	Description
	Ansible	Provisioning machines
	Flux	Flux is a set of continuous and progressive delivery solutions for Kubernetes that are open and extensible.
	cert-manager	Cloud native certificate management
	External Secrets	Kubernetes operator that integrates external secret management systems
	Forgejo	Self-hosted DevOps Platform
	Helm	The package manager for Kubernetes
	K3s	Lightweight distribution of Kubernetes
	Zitadel	Identity and Access Management
	MinIO	Multi-Cloud Object Storage
	OpenEBS (zfs-localpv)	CSI driver for provisioning Local PVs backed by ZFS
	PostgreSQL	Object-relational database
	Traefik proxy	Kubernetes Ingress Controller
	OpenBao	Secrets and encryption management system
	Vicoria Metrics	Monitoring system (like prometheus)
	Grafana	Graph dashboard for monitoring

Get started

• Try it out locally without any hardware
• Deploy to real hardware for production workload

Roadmap

See roadmap for a list of proposed features.