Homelab

This is my homelab set up, it focused on automation to simplify provisioning, upgrading, and operating self-hosted services.

! ⚠️ WORK IN PROGRESS

Overview

Hardware

• 4 nodes of NEC SFF PC-MK26ECZDR (Japanese version of the ThinkCentre M700):
  • CPU: Intel Core i5-6600T @ 2.70GHz
  • RAM: 16GB
  • SSD: 128GB
• TP-Link TL-SG108 switch:
  • Ports: 8
  • Speed: 1000Mbps

Technology stack

Logo	Name	Description
	Ansible	Automate bare metal provisioning and configuration
	ArgoCD	GitOps tool built to deploy applications to Kubernetes
	Cloudflare	DNS and Tunnel
	Docker	Ephermeral PXE server and convenient tools container
	Gitea	Self-hosted Git service
	Grafana	Operational dashboards
	Helm	The package manager for Kubernetes
	K3s	Lightweight distribution of Kubernetes
	Kubernetes	Container-orchestration system, the backbone of this project
	Let's Encrypt	Free, automated (via cert-manager), and open certificate authority
	Loki	Log aggregation system
	Longhorn	Cloud native distributed block storage for Kubernetes
	MetalLB	Bare metal load-balancer for Kubernetes
	NGINX	Kubernetes Ingress Controller
	Prometheus	Systems monitoring and alerting toolkit
	Rocky Linux	Base OS for Kubernetes nodes
	Tekton	Cloud native solution for building CI/CD systems
	Vault	Secrets and encryption management system

Get Started

• Try it out on a VM without any hardware
• Deploy on real hardware for real workload

Roadmap

See roadmap and open issues for a list of proposed features and known issues.

Contributing

Any contributions you make are greatly appreciated (feature, bug fix, documentation, grammar or typo fix...).

License

Distributed under the GPLv3 License. See LICENSE for more information.

Acknowledgements

• ArgoCD usage in my coworker's homelab
• README template
• Run the same Cloudflare Tunnel across many cloudflared processes
• MAC address environment variable in GRUB config
• Official k3s systemd service file

Stargazers over time