# khuedoan/homelab

Fully automated homelab from empty disk to running services with a single command.

Repository: https://github.com/khuedoan/homelab
Canonical: https://ross.abutalabs.com/products/homelab
Homepage: https://homelab.khuedoan.com
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: kubernetes, pxe, homelab, ansible, docker, helm, k3s, argocd, terraform, devops, self-hosting, fedora, netboot, k8s-at-home, gitops, home-operations
Last push: 2026-06-06T06:46:48+00:00

## Health v2 (maintenance only)
Score: 62/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 86, release rhythm 8, longevity 100
- inputs: {"age_days": 2264, "days_push": 88, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 9541, forks 877 (observed 2026-08-28T04:10:31.779573+00:00)

## What it is
A fully automated homelab framework that provisions bare-metal machines from empty disk (via PXE boot), installs Kubernetes, and deploys self-hosted services using Infrastructure as Code and GitOps with a single command. It is highly customizable and intended to be forked as a foundation for building your own homelab.

## Use cases
- automate homelab setup from empty disk to running services
- provision bare metal servers with PXE boot and install kubernetes
- manage self-hosted apps with gitops and argocd
- build a customizable k3s cluster at home
- set up automated backups, monitoring, and sso for self-hosted services
- expose home services securely with cloudflare tunnel and vpn
- test infrastructure changes in a sandbox cluster before production

## When to choose
- you want a complete, opinionated, one-command homelab with kubernetes and gitops
- you have x86_64 machines on the same network that support PXE boot and wake-on-lan
- you want automated OS/k8s rolling upgrades, certificate management, DNS updates, and backups out of the box
- you are comfortable forking a repo and customizing Ansible/Terraform/Helm configs

## When to avoid
- you need a stable, production-grade system with a guaranteed upgrade path (project is ALPHA with breaking changes)
- you don't run Linux (PXE boot host networking requires Linux; macOS/Windows need a bridged VM)
- you want a simple docker-compose style self-hosting setup without kubernetes
- you can't tolerate occasional full redeploys or want critical services on it

## Facets
- artifact type: infra-config
- maturity: experimental
- function: infrastructure-as-code, container-orchestration, deployment, configuration-management, ci-cd, self-hosted, backup, monitoring, alerting, security
- domain: self-hosted, infrastructure-as-code, cloud-computing, developer-tools
- platform: self-hosted, python, go
- tags: homelab, gitops, pxe-boot, k3s, ansible, terraform, argocd, helm, bare-metal-provisioning, k8s-at-home, tailscale, wireguard, cloudflare-tunnel, single-sign-on, devops, containers, automation, linux, kubernetes, docker

## Member repositories
- khuedoan/homelab (main) score 62

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:31.779573+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:21:58.457183+00:00, confidence not recorded.
  - readme: https://github.com/khuedoan/homelab (fetched 2026-08-28T04:10:31.779573+00:00, sha 4446c507f5d2)
  - homepage: https://homelab.khuedoan.com (fetched 2026-08-29T08:21:58.256452+00:00, sha 269f95cfc545)
  - site_page: https://homelab.khuedoan.com/installation/sandbox (fetched 2026-08-29T08:21:58.265665+00:00, sha d3126423a87c)
  - site_page: https://homelab.khuedoan.com/installation/production/prerequisites (fetched 2026-08-29T08:21:58.267514+00:00, sha 72b18e34df12)
  - site_page: https://homelab.khuedoan.com/installation/production/external-resources (fetched 2026-08-29T08:21:58.269296+00:00, sha dc6778571fef)
  - site_page: https://homelab.khuedoan.com/installation/production/configuration (fetched 2026-08-29T08:21:58.271467+00:00, sha 5454372f0e99)
  - site_page: https://homelab.khuedoan.com/installation/production/deployment (fetched 2026-08-29T08:21:58.273467+00:00, sha 833d9d9d6d21)
  - site_page: https://homelab.khuedoan.com/installation/post-installation (fetched 2026-08-29T08:21:58.275051+00:00, sha 1b6e212645ac)
  - site_page: https://homelab.khuedoan.com/getting-started/vpn-setup (fetched 2026-08-29T08:21:58.277303+00:00, sha de4ec8d3338d)
  - site_page: https://homelab.khuedoan.com/getting-started/user-onboarding (fetched 2026-08-29T08:21:58.278909+00:00, sha 8b5f9cb79c18)
- Data as of 2026-08-30T08:39:29.467469+00:00.