UseAfterMe

UseAfterMe / Kubeforge

Public

Build repeatable kubeadm-based Kubernetes clusters on Proxmox with OpenTofu, cloud-init, and Ansible

ansible automation cloud-init enterprise homelab
10
1
100% credibility
Found Apr 17, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Shell
AI Summary

Kubeforge automates the creation and management of Kubernetes clusters on Proxmox servers for homelabs and production-like environments.

How It Works

1
🔍 Discover Kubeforge

You find this handy tool on GitHub while looking for an easy way to set up a Kubernetes cluster at home or in your lab.

2
⚙️ Answer setup questions

You run a simple interactive guide to pick your server details, network setup, and how many machines you want.

3
🚀 Create your machines

Hit go, and watch as virtual machines pop up on your Proxmox server, perfectly configured for your needs.

4
🌐 Bring the cluster to life

One more command installs Kubernetes, networking, and helpful services across all your new machines.

5
✅ Quick health check

Run a simple test to confirm everything is running smoothly with all parts ready to go.

🎉 Enjoy your cluster

Your production-ready Kubernetes playground is live—connect your tools, run apps, and start experimenting!

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is Kubeforge?

Kubeforge is a Shell-based CLI tool that builds repeatable kubeadm-based Kubernetes clusters on Proxmox using OpenTofu for VM provisioning, cloud-init for bootstrapping, and Ansible for node prep. It spins up production-style setups with Cilium networking, Traefik ingress, kube-vip for HA API endpoints, and optional Proxmox CSI storage—handling everything from homelabs to edge deployments. Run `./deploy.sh configure apply bootstrap health` for a ready cluster with merged kubeconfig and post-bootstrap validation.

Why is it gaining traction?

It delivers full lifecycle management: smart multi-cluster destroy/upgrade workflows, automatic tool installs, subnet validation, and health checks for nodes/pods/LB IPs, without MetalLB or extra HAProxy VMs. Developers love the interactive config flow with presets for Ubuntu/Rocky, IP/VMID planning, and kubeconfig merging that preserves existing contexts. Repeatable builds via tracked history make it dead simple to rebuild or tweak clusters.

Who should use this?

Proxmox admins building Kubernetes labs, homelab tinkerers testing Cilium/Traefik stacks, or edge engineers needing kubeadm clusters without cloud vendor lock-in. Ideal for teams wanting quick, controlled K8s on bare metal with CSI for local storage moves.

Verdict

Grab it if you're on Proxmox and need repeatable Kubernetes—docs are thorough, commands intuitive, but with 10 stars and 1.0% credibility, it's early-stage; test in a lab first. Solid for controlled builds, less so for massive prod scales.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.