k3d

# k3d - Kubernetes Clusters

## Overview

The `k3d` command manages lightweight Kubernetes (k3s) clusters running in Podman containers. Clusters are joined to the bazzite-ai network, enabling DNS-based service discovery with other pods (ollama, jupyter, etc.).

**Key Concept:** k3d wraps k3s (lightweight Kubernetes) in containers, providing fast cluster creation with full Kubernetes API compatibility. GPU passthrough is supported via NVIDIA device plugin.

## Quick Reference

| Action | Command | Description |
|--------|---------|-------------|
| Config | `ujust k3d config [--port=...] [--agents=...]` | Create k3d cluster on bazzite-ai network |
| Start | `ujust k3d start [--instance=N]` | Start k3d cluster |
| Stop | `ujust k3d stop [--instance=N]` | Stop k3d cluster |
| Restart | `ujust k3d restart [--instance=N]` | Restart k3d cluster |
| Logs | `ujust k3d logs [--instance=N] [--lines=N]` | View k3s server logs |
| Status | `ujust k3d status [--instance=N]` | Show cluster status and nodes |
| Shell | `ujust k3d shell [--instance=N] [-- CMD]` | Execute kubectl commands |
| GPU | `ujust k3d gpu [--instance=N]` | Setup GPU support (NVIDIA device plugin) |
| List | `ujust k3d list` | List all k3d clusters |
| Delete | `ujust k3d delete [--instance=N]` | Remove k3d cluster and cleanup |

## Parameters

| Parameter | Long Flag | Short | Default | Description |
|-----------|-----------|-------|---------|-------------|
| action | (positional) | - | required | Action: config, start, stop, etc. |
| port | `--port` | `-p` | `6443` | Kubernetes API port |
| bind | `--bind` | `-b` | `127.0.0.1` | Bind address for API server |
| agents | `--agents` | `-a` | `0` | Number of agent (worker) nodes |
| instance | `--instance` | `-n` | `1` | Cluster instance number |
| gpu_type | `--gpu-type` | `-g` | `auto` | GPU type (auto/nvidia/amd/intel/none) |
| lines | `--lines` | `-l` | `50` | Log lines to show |
| http_port | `--http-port` | - | `80` | Traefik HTTP ingress port |
| https_po