smoki99

How to Setup K3s on Debian 13 with Traefik and ArgoCD for a Homelab

This guide details the complete process of setting up a multi-node K3s Kubernetes cluster on a single Debian 13 host using LXC containers. It is tailored for a homelab environment and includes solutions to common pitfalls encountered when running Kubernetes inside containers.

The final result is a robust, 3-node cluster (1 master, 2 workers) with a working Ingress Controller (Traefik) and a GitOps tool (Argo CD), accessible from your local network.

Table of Contents

1. Part 1: Host System Preparation
2. Part 2: Creating the K3s Master Node
3. Part 3: Creating the K3s Worker Nodes

smoki99

Guide: Configuring virtiofs Persistent Storage for a K3s LXC Cluster

Goal

This guide details the complete, end-to-end process for providing a persistent storage directory from a KVM/QEMU hypervisor to a Debian VM, then down into LXC containers, and finally making it available for use by a K3s cluster via Persistent Volumes.

This architecture allows for high-performance, centrally managed storage for your stateful applications running in Kubernetes.

Architecture: KVM Hypervisor Host → Debian Guest VM → LXC Containers (K3s Nodes) → Kubernetes Pods

smoki99

#!/bin/bash
# WAN 2.2 I2V (Q4_K_S) Downloader
# Uses aria2c for large GGUF models for max speed
# Smaller files use hf download with HF Transfer
# Destination: /mnt/data1/models

set -e

# ===== CONFIG =====
BASE_DIR="/mnt/data1/models"