docs: deprecate LXC 113 references after Frigate K3s migration

Frigate moved from LXC 113 on fun-bedbug to a K3s pod on
k3s-vm-pumped-piglet-gpu (RTX 3070, ONNX detector). Updates the
operational docs and one VMID->host mapping script so future readers
(human and AI) aren't misdirected to a container that no longer exists.
Historical records (blog posts, migration runbooks, action logs) are
left intact.

fixes #188

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: kumar gopal

CLAUDE.md

@@ -385,15 +385,18 @@ Always use `namespace="home"` for this repo.
 ## Service-Specific Update Policies
 
 ### Frigate NVR
-- **WAIT for PVE Helper Scripts** to support new versions
-- LXC 113 on fun-bedbug.maas (AMD A9-9400)
-- Reference: `docs/reference/frigate-upgrade-decision-framework.md`
+- Runs as a K3s pod (namespace `frigate`) pinned to `k3s-vm-pumped-piglet-gpu` via nodeSelector
+- Detector: ONNX on RTX 3070 (`nvidia.com/gpu: 1`) — Coral TPU no longer used by Frigate
+- Manifests: `gitops/clusters/homelab/apps/frigate/` (Flux-managed)
+- URL: https://frigate.app.home.panderosystems.com
+- **DEPRECATED**: Frigate previously ran as LXC 113 on fun-bedbug; that LXC is gone. Migration history is in `docs/runbooks/frigate-migration-to-still-fawn-k3s.md` and `scripts/frigate/virtiofs-import/`.
+- Reference: `docs/reference/frigate-upgrade-decision-framework.md` (parts about LXC 113 are historical)
 
 ### Coral USB TPU - CRITICAL
-**NEVER test from host while LXC has it mounted!**
+**NEVER test the Coral from a Proxmox host while a VM/LXC has it passed through!**
 - Corrupts Coral state ("did not claim interface 0")
 - ONLY FIX: Physical unplug/replug
-- Check INSIDE container: `pct exec 113 -- cat /dev/shm/logs/frigate/current | grep -i TPU`
+- Coral USB is currently passed through to `k3s-vm-still-fawn` (VMID 108 on still-fawn). It is **not** in use by Frigate anymore (Frigate uses RTX 3070 ONNX detector); check whether any pod still needs it before touching.
 
 ### GPU Passthrough (VFIO)
 **MANDATORY FIRST**: Check BIOS VT-d
@@ -407,7 +410,9 @@ ls /sys/kernel/iommu_groups/ | wc -l  # If 0 → VT-d disabled in BIOS
 ## Proxmox Host Inventory
 | Hostname | Role | Key Hardware |
 |----------|------|--------------|
-| still-fawn.maas | K3s VM host | AMD Radeon GPU, Coral USB TPU, Frigate pod |
-| pumped-piglet.maas | K3s VM host | RTX 3070 GPU |
+| still-fawn.maas | K3s VM host | AMD Radeon GPU (VAAPI), Coral USB TPU (idle — was Frigate) |
+| pumped-piglet.maas | K3s VM host | RTX 3070 GPU — runs Frigate pod (ONNX detector) |
 | chief-horse.maas | HAOS host (VMID 116) | - |
-| fun-bedbug.maas | LXC host | - |
+| fun-bedbug.maas | LXC host | (formerly hosted Frigate LXC 113 — now decommissioned) |
+| pve.maas | K3s + LXC host | OPNsense, MAAS, cloudflared, docker LXC, k3s-vm-pve |
+| rapid-civet.maas | (intentionally offline) | - |

docs/reference/frigate-upgrade-decision-framework.md

@@ -1,5 +1,7 @@
 # Frigate Upgrade Decision Framework
 
+> **⚠️ DEPRECATED (kept for historical reference).** This document describes the upgrade workflow for Frigate as a Proxmox LXC (LXC 113 on fun-bedbug), which has been retired. Frigate now runs as a K3s pod managed by Flux (`gitops/clusters/homelab/apps/frigate/`). The "wait for PVE Helper Scripts" rule no longer applies — upgrades are done by bumping the container image tag in the deployment manifest. See `docs/runbooks/frigate-migration-to-still-fawn-k3s.md` for migration history.
+
 ## MANDATORY Pre-Upgrade Checks
 
 **BEFORE considering any Frigate upgrade, ALWAYS follow this checklist:**

docs/reference/homelab-service-inventory.md

@@ -55,7 +55,7 @@ graph TB
 
     subgraph LXC_Containers[LXC Containers]
         PBS[Proxmox Backup Server<br>LXC 103<br>pumped-piglet<br>192.168.4.218<br>1.3TB/21TB storage]
-        FRIG[Frigate NVR<br>LXC 113<br>fun-bedbug<br>AMD Radeon R5 + Coral TPU]
+        FRIG[Frigate NVR<br>K3s pod<br>k3s-vm-pumped-piglet-gpu<br>RTX 3070 ONNX detector]
         DOCK[Docker Host<br>LXC 112<br>fun-bedbug]
     end
 
@@ -137,7 +137,8 @@ ssh ubuntu@192.168.4.210             # k3s-vm-pumped-piglet-gpu
 ssh gshiva@192.168.4.83              # Webtop development environment
 
 # LXC Containers
-ssh root@192.168.4.<frigate-ip>      # Frigate NVR (LXC 113)
+# (Frigate is no longer an LXC — it's a K3s pod on k3s-vm-pumped-piglet-gpu,
+#  reach the UI at https://frigate.app.home.panderosystems.com)
 ssh root@192.168.4.<docker-ip>       # Docker host (LXC 112)
 ```
 
@@ -295,16 +296,15 @@ curl -X POST http://ollama.app.homelab/api/generate \
 
 ### Frigate NVR
 
-**Type**: LXC Container 113 on fun-bedbug.maas
-**Hardware**: AMD Radeon R5 (renderD128), Google Coral TPU (USB)
-**Storage**: 500G mount at `/media` (local-3TB-backup)
+**Type**: K3s pod (namespace `frigate`), pinned to `k3s-vm-pumped-piglet-gpu` via nodeSelector
+**Hardware**: NVIDIA RTX 3070 (passed through to VM 105 on pumped-piglet, then exposed to the pod via `nvidia.com/gpu: 1`)
+**Detector**: ONNX on RTX 3070 (Coral TPU no longer used by Frigate)
+**Manifests**: `gitops/clusters/homelab/apps/frigate/` (Flux-managed)
+**Storage**: ZFS-backed PVCs; old recordings imported from former LXC 113 via `scripts/frigate/virtiofs-import/`
 
-**Access**: http://<frigate-ip>:5000 (check fun-bedbug DHCP lease)
+**Access**: https://frigate.app.home.panderosystems.com (Traefik 192.168.4.80, valid LE wildcard cert)
 
-**Features**:
-- Object detection with Coral TPU
-- AMD GPU hardware acceleration
-- Face recognition (requires Frigate 0.16.0+, waiting for PVE Helper Scripts update)
+**History**: Previously ran as LXC 113 on fun-bedbug with Coral USB + AMD VAAPI. Decommissioned during migration to K3s. See `docs/runbooks/frigate-migration-to-still-fawn-k3s.md` and the ONNX detector action logs in `scripts/frigate/`.
 
 ### Netdata Monitoring
 
@@ -415,8 +415,8 @@ gitops/clusters/homelab/
 
 **fun-bedbug.maas (192.168.4.172)**
 - CPU: AMD A9-9400 (low-power)
-- GPU: AMD Radeon R5 (integrated, used by Frigate)
-- TPU: Google Coral USB (passed to Frigate LXC 113)
+- GPU: AMD Radeon R5 (integrated; previously used by Frigate LXC 113, now idle)
+- TPU: (previously hosted Google Coral USB for Frigate LXC 113; LXC retired, Coral USB now passed to still-fawn / k3s-vm-still-fawn)
 - RAM: Unknown (check via `lshw`)
 - Storage: 1TB local + 3TB ZFS
 - Network: 2.5GbE vmbr0 (USB adapter)

docs/reference/proxmox-vm-configurations.md

@@ -630,6 +630,8 @@ qm set 116 --agent 1
 
 ### LXC 113: Frigate NVR
 
+> **⚠️ DEPRECATED — historical reference only.** LXC 113 has been retired. Frigate now runs as a K3s pod on `k3s-vm-pumped-piglet-gpu` (RTX 3070 ONNX detector) — see `gitops/clusters/homelab/apps/frigate/`. The configuration below is preserved as a recovery / rebuild reference, not the current state.
+
 **Host**: fun-bedbug.maas (192.168.4.172)
 
 ```

docs/source/md/homelab-network-topology.md

@@ -75,9 +75,9 @@ This document describes the complete network topology of the homelab, including
 │   │     PVE      │  │  STILL-FAWN  │  │ CHIEF-HORSE  │  │  FUN-BEDBUG  │        │
 │   │  .4.122      │  │    .4.17     │  │    .4.19     │  │    .4.172    │        │
 │   │              │  │              │  │              │  │              │        │
-│   │ • Gateway    │  │ • K3s VM     │  │ • K3s VM     │  │ • Frigate    │        │
-│   │ • K3s VM     │  │   .4.212     │  │   .4.237     │  │   LXC 113    │        │
-│   │   .4.238     │  │              │  │ • HA VM      │  │              │        │
+│   │ • Gateway    │  │ • K3s VM     │  │ • K3s VM     │  │ • K3s VM     │        │
+│   │ • K3s VM     │  │   .4.212     │  │   .4.237     │  │   .4.192     │        │
+│   │   .4.238     │  │              │  │ • HA VM      │  │ • Docker LXC │        │
 │   │              │  │              │  │   .4.240     │  │              │        │
 │   └──────────────┘  └──────────────┘  └──────────────┘  └──────────────┘        │
 │                                              │                                   │
@@ -135,7 +135,12 @@ This document describes the complete network topology of the homelab, including
 
 | Container | CTID | Host | Purpose |
 |-----------|------|------|---------|
-| Frigate | 113 | fun-bedbug | NVR with Coral TPU |
+| docker | 112 | fun-bedbug | Docker host |
+| proxmox-backup-server | 103 | pumped-piglet | PBS datastore |
+| docker | 100 | pve | Docker host |
+| cloudflared | 111 | pve | Cloudflare tunnel |
+
+> Frigate was previously LXC 113 on fun-bedbug; it now runs as a K3s pod on `k3s-vm-pumped-piglet-gpu` (RTX 3070 ONNX detector) — see `gitops/clusters/homelab/apps/frigate/`.
 
 ### K3s Services (MetalLB)
 

docs/source/md/proxmox-infrastructure-guide.md

@@ -92,7 +92,7 @@ graph TB
     
     subgraph "LXC Network Assignment"
         vmbr0 --> lxc_wan[LXC containers on WAN<br/>docker LXC-100, cloudflared LXC-111]
-        vmbr25gbe --> lxc_lan[LXC containers on LAN<br/>docker LXC-112, frigate LXC-113<br/>proxmox-backup-server LXC-103]
+        vmbr25gbe --> lxc_lan[LXC containers on LAN<br/>docker LXC-112<br/>proxmox-backup-server LXC-103]
     end
 ```
 
@@ -346,33 +346,30 @@ Features:
 Tags: cloudflare, community-script, network
 ```
 
-#### Frigate NVR (LXC 113)
+#### Frigate NVR (~~LXC 113~~ — now a K3s pod)
+
+> **⚠️ DEPRECATED.** Frigate is no longer an LXC. It runs as a K3s pod on `k3s-vm-pumped-piglet-gpu` (RTX 3070 ONNX detector), managed via Flux at `gitops/clusters/homelab/apps/frigate/`. The LXC-era details below are historical.
+
 ```yaml
-Location: fun-bedbug node
+# Historical: LXC 113 on fun-bedbug, retired during K3s migration.
+Location: fun-bedbug node (RETIRED)
 Purpose: Network Video Recorder with AI detection
 Resources:
   - CPU: 4 cores
   - RAM: 4GB
   - Storage: 500GB from local-3TB-backup ZFS pool
-Network:
-  - eth0: vmbr25gbe, DHCP
-Features:
-  - High CPU usage for video processing
-  - AI-powered object detection
-  - Storage migrated from Samsung T5 USB to 3TB HDD SATA
-  - 16x storage capacity increase (from 928GB to 2.72TB pool)
-Current Version: 0.14.1 (installed via PVE Helper Scripts)
 Hardware Acceleration:
   - AMD Radeon R5 GPU with VA-API (preset-vaapi)
   - Google Coral USB TPU for object detection
-  - Automated TPU initialization via coral-tpu-init.service
-Upgrade Policy:
-  - Wait for PVE Helper Scripts to support newer versions
-  - DO NOT manually update - breaks LXC integration
-  - Face recognition requires v0.16.0+ (pending script update)
-Tags: community-script, nvr
+Last LXC Version: 0.14.1 (installed via PVE Helper Scripts)
 ```
 
+**Current deployment:**
+- Manifests: `gitops/clusters/homelab/apps/frigate/`
+- Detector: ONNX on RTX 3070 (`nvidia.com/gpu: 1`)
+- URL: https://frigate.app.home.panderosystems.com
+- Upgrades: bump image tag in `deployment.yaml`, commit, `flux reconcile`
+
 #### Proxmox Backup Server (LXC 103)
 ```yaml
 Location: still-fawn node
@@ -582,7 +579,7 @@ graph TB
 - **100** - docker-pve (Docker services)
 - **111** - cloudflared (Tunnel service)
 - **112** - docker-fun-bedbug (Docker services)
-- **113** - frigate (NVR/Security cameras)
+- ~~**113** - frigate~~ (decommissioned — Frigate now runs as a K3s pod, see `gitops/clusters/homelab/apps/frigate/`)
 
 **Excluded**:
 - **103** - proxmox-backup-server (Prevents recursive backups)

gitops/clusters/homelab/instances/README.md

@@ -26,16 +26,16 @@ Use the `external-name` annotation to adopt existing infrastructure:
 ```yaml
 metadata:
   annotations:
-    crossplane.io/external-name: "113"  # Existing VMID
+    crossplane.io/external-name: "112"  # Existing VMID (example: docker LXC)
 spec:
   deletionPolicy: Orphan  # Don't delete if CR removed from Git
 ```
 
 Generate YAML from existing VM/LXC:
 
 ```bash
-# Generate from existing LXC
-./scripts/crossplane/import-lxc.sh 113 > frigate-nvr.yaml
+# Generate from existing LXC (example: docker LXC on fun-bedbug)
+./scripts/crossplane/import-lxc.sh 112 > docker-host.yaml
 
 # Generate from existing VM
 ./scripts/crossplane/import-vm.sh 200 > my-vm.yaml
@@ -52,4 +52,4 @@ Generate YAML from existing VM/LXC:
 | File | VMID | Node | Purpose |
 |------|------|------|---------|
 | rancher-server.yaml | 200 | pumped-piglet | RKE2 eval (test) |
-| frigate-nvr.yaml | 113 | fun-bedbug | Frigate NVR (adopt) |
+| ~~frigate-nvr.yaml~~ | ~~113~~ | ~~fun-bedbug~~ | **Removed** — Frigate migrated to K3s pod (see `apps/frigate/`) |

scripts/perf/run-on-proxmox-vm.sh

@@ -19,8 +19,9 @@ get_host() {
     case "$1" in
         116|109) echo "chief-horse.maas" ;;
         108) echo "still-fawn.maas" ;;
-        105) echo "pumped-piglet.maas" ;;
-        113) echo "fun-bedbug.maas" ;;  # LXC
+        105|103) echo "pumped-piglet.maas" ;;  # 103 = PBS LXC
+        114|112) echo "fun-bedbug.maas" ;;  # 114 = k3s VM, 112 = docker LXC
+        107|100|101|102|111) echo "pve.maas" ;;
         *) echo "chief-horse.maas" ;;
     esac
 }