skills.rest
drewid74
drewid74COMMUNITY
Explore all skills by this author →
GitHub

proxmox-k3s-infra

Provision and troubleshoot Proxmox homelab infrastructure for K3s Kubernetes clusters.

8|1|Updated Mar 30, 2026
Search Tags:#kubernetes#terraform#gitops#proxmox#cloud-init#k3s#gpu passthrough
One-click install
npx skills add https://github.com/drewid74/ai_skills --skill proxmox-k3s-infra
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: proxmox-k3s-infra
Source: https://github.com/drewid74/ai_skills/tree/main/proxmox-k3s-infra
Command: npx skills add https://github.com/drewid74/ai_skills --skill proxmox-k3s-infra

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you set up and troubleshoot a Proxmox-based homelab Kubernetes (K3s) and VM/LXC infrastructure so nodes join correctly, GPU passthrough works, storage and backups are reliable, and the whole environment can be rebuilt reproducibly.

Core Features & Use Cases

  • Proxmox + K3s deployment guidance: Choose VMs vs LXC correctly, size nodes for single-node or multi-node clusters, and install K3s using a repeatable approach.
  • GPU passthrough validation and fixes: Apply the right IOMMU/vfio workflow and detect common issues like incorrect IOMMU grouping.
  • Automation-ready infrastructure with guardrails: Use Terraform for declarative VM lifecycle, set up GitOps for cluster apps, and back up VMs/K3s (including restore confidence checks).

What problem does it solve?

Real-world example: you want to turn a fresh Proxmox host into a working K3s cluster with Longhorn storage for persistent workloads, configure GPU passthrough so workloads can use hardware acceleration, and then ensure everything can be rebuilt via templates and IaC without manual drift.

Quick Start

Ask for a step-by-step Proxmox + K3s plan that includes VM templates with cloud-init, node sizing, GPU passthrough checks, and a minimal GitOps bootstrap for persistent workloads.

Frequently Asked Questions about proxmox-k3s-infra

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a K3s cluster on Proxmox with deterministic rebuilds?▼

To deploy K3s on Proxmox deterministically, use cloud-init templates for VM creation and Terraform for declarative lifecycle management, ensuring the entire infrastructure can be rebuilt reproducibly from code without manual drift.

Why does K3s node join fail on Proxmox VMs and how to fix it?▼

K3s node join problems on Proxmox often stem from incorrect node sizing or network configuration; resolving these involves applying a repeatable K3s installation approach and validating VM templates to ensure nodes join the cluster correctly.

How to configure GPU passthrough with vfio-pci in a Proxmox Kubernetes setup?▼

Configure Proxmox GPU passthrough by applying the correct IOMMU and vfio workflow, validating vfio-pci binding, and detecting common issues like incorrect IOMMU grouping to ensure workloads can use hardware acceleration.

Should I use Proxmox VMs or LXC containers for a K3s homelab cluster?▼

Choosing Proxmox VMs versus LXC for K3s depends on your workload requirements, where VMs offer full isolation and kernel-level features like GPU passthrough, while LXC provides lighter overhead for standard node deployments.

What is the best way to bootstrap GitOps and persistent storage on Proxmox K3s?▼

The best way to bootstrap GitOps on Proxmox K3s is using a minimal GitOps deployment for cluster apps alongside reliable storage solutions like Longhorn, ensuring persistent workloads and synced application states.

Related Skills

Explore More Software Engineering Skills→
bossjonesbossjones
1

proxmox-infrastructure

Manage Proxmox VE infrastructure via proxmoxer, Ansible, and Terraform.

Community
Advanced
cogni-daocogni-dao
4

deploy-operator

Automate Cogni operator and node deployment to k3s clusters with Argo CD.

Official
Advanced
gke-labsgke-labs
42

workload-rebalancing

Orchestrate cross-cluster Kubernetes workload migration with validation checks and GitOps PR generation.

Official
Advanced
fred-drakefred-drake
27

infrastructure

Deploy NixOS configurations with Colmena across Proxmox LXC containers and bare-metal hosts.

Community
Advanced