Initial commit: KavCorp infrastructure documentation

- CLAUDE.md: Project configuration for Claude Code - docs/: Infrastructure documentation - INFRASTRUCTURE.md: Service map, storage, network - CONFIGURATIONS.md: Service configs and credentials - CHANGELOG.md: Change history - DECISIONS.md: Architecture decisions - TASKS.md: Task tracking - scripts/: Automation scripts 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-07 22:07:01 -05:00
commit 120c2ec809
19 changed files with 3448 additions and 0 deletions
--- a/docs/inventory.md
+++ b/docs/inventory.md
@@ -0,0 +1,289 @@
+# VM and LXC Inventory
+
+**Last Updated**: 2025-11-16
+
+## Virtual Machines
+
+### VMID 100 - haos12.1 (Home Assistant OS)
+- **Node**: pm1
+- **Type**: QEMU VM
+- **CPU**: 2 cores
+- **Memory**: 4GB
+- **Disk**: 32GB
+- **Status**: Running
+- **Uptime**: ~52 hours
+- **Tags**: proxmox-helper-scripts
+- **Purpose**: Home automation platform
+
+### VMID 109 - docker-pm3
+- **Node**: pm3
+- **Type**: QEMU VM
+- **CPU**: 4 cores
+- **Memory**: 12GB
+- **Disk**: 100GB
+- **Status**: Running
+- **Uptime**: ~190 hours (~8 days)
+- **Purpose**: Docker host for containerized services
+- **Notes**: Primary Docker host, high network traffic
+
+## LXC Containers
+
+### Infrastructure Services
+
+#### VMID 104 - traefik
+- **Node**: pm2
+- **IP**: 10.4.2.10
+- **CPU**: 2 cores
+- **Memory**: 2GB
+- **Disk**: 10GB (KavNas)
+- **Status**: Running
+- **Tags**: community-script, proxy
+- **Purpose**: Reverse proxy and load balancer
+- **Features**: Unprivileged, nesting enabled
+- **Uptime**: ~2.5 hours
+
+#### VMID 106 - mqtt
+- **Node**: pm3
+- **CPU**: 1 core
+- **Memory**: 512MB
+- **Disk**: 2GB (local-lvm)
+- **Status**: Running
+- **Tags**: proxmox-helper-scripts
+- **Purpose**: MQTT message broker for IoT devices
+- **Uptime**: ~319 hours (~13 days)
+- **Notes**: High inbound network traffic (3.4GB)
+
+#### VMID 116 - authelia
+- **Node**: pm2
+- **IP**: 10.4.2.23
+- **CPU**: 1 core
+- **Memory**: 512MB
+- **Disk**: 2GB (KavNas)
+- **Status**: Running
+- **Tags**: authenticator, community-script
+- **Purpose**: Authentication and authorization server
+- **Features**: Unprivileged, nesting enabled
+- **Uptime**: ~1.9 hours
+
+### Media Stack (*arr services)
+
+#### VMID 105 - sonarr
+- **Node**: pm2
+- **IP**: 10.4.2.15
+- **CPU**: 2 cores
+- **Memory**: 1GB
+- **Disk**: 4GB (KavNas)
+- **Mount Points**:
+  - /media → elantris-media (NFS)
+  - /mnt/kavnas → KavNas (NFS)
+- **Status**: Running
+- **Tags**: arr, community-script
+- **Features**: Unprivileged, nesting enabled
+- **Uptime**: ~56 minutes
+
+#### VMID 108 - radarr
+- **Node**: pm2
+- **IP**: 10.4.2.16
+- **CPU**: 2 cores
+- **Memory**: 1GB
+- **Disk**: 4GB (KavNas)
+- **Mount Points**:
+  - /media → elantris-media (NFS)
+  - /mnt/kavnas → KavNas (NFS)
+- **Status**: Running
+- **Tags**: arr, community-script
+- **Features**: Unprivileged, nesting enabled
+- **Uptime**: ~56 minutes
+
+#### VMID 114 - prowlarr
+- **Node**: pm2
+- **IP**: 10.4.2.17
+- **CPU**: 2 cores
+- **Memory**: 1GB
+- **Disk**: 4GB (KavNas)
+- **Status**: Running
+- **Tags**: arr, community-script
+- **Features**: Unprivileged, nesting enabled
+- **Purpose**: Indexer manager for *arr services
+- **Uptime**: ~56 minutes
+
+#### VMID 117 - whisparr
+- **Node**: pm2
+- **IP**: 10.4.2.19
+- **CPU**: 2 cores
+- **Memory**: 1GB
+- **Disk**: 4GB (KavNas)
+- **Status**: Running
+- **Tags**: arr, community-script
+- **Features**: Unprivileged, nesting enabled
+- **Uptime**: ~56 minutes
+
+#### VMID 119 - bazarr
+- **Node**: pm2
+- **IP**: 10.4.2.18
+- **CPU**: 2 cores
+- **Memory**: 1GB
+- **Disk**: 4GB (KavNas)
+- **Status**: Running
+- **Tags**: arr, community-script
+- **Features**: Unprivileged, nesting enabled
+- **Purpose**: Subtitle management for Sonarr/Radarr
+- **Uptime**: ~56 minutes
+
+### Media Servers
+
+#### VMID 115 - jellyseerr
+- **Node**: pm2
+- **IP**: 10.4.2.20
+- **CPU**: 4 cores
+- **Memory**: 4GB
+- **Disk**: 8GB (KavNas)
+- **Status**: Running
+- **Tags**: community-script, media
+- **Features**: Unprivileged, nesting enabled
+- **Purpose**: Request management for Jellyfin
+- **Uptime**: ~56 minutes
+
+#### VMID 120 - kometa
+- **Node**: pm2
+- **IP**: 10.4.2.21
+- **CPU**: 2 cores
+- **Memory**: 4GB
+- **Disk**: 8GB (KavNas)
+- **Status**: Running
+- **Tags**: community-script, media, streaming
+- **Features**: Unprivileged, nesting enabled
+- **Purpose**: Media library metadata manager
+- **Uptime**: ~1.9 hours
+
+#### VMID 121 - jellyfin
+- **Node**: elantris
+- **IP**: 10.4.2.22
+- **CPU**: 2 cores
+- **Memory**: 2GB
+- **Disk**: 16GB (el-pool)
+- **Status**: Running
+- **Tags**: community-script, media
+- **Features**: Unprivileged, nesting enabled
+- **Purpose**: Media server
+- **Uptime**: ~19 minutes
+- **Notes**: Recently migrated to elantris
+
+#### VMID 118 - notifiarr
+- **Node**: pm2
+- **IP**: 10.4.2.24
+- **CPU**: 1 core
+- **Memory**: 512MB
+- **Disk**: 2GB (KavNas)
+- **Status**: Running
+- **Tags**: arr, community-script
+- **Features**: Unprivileged, nesting enabled
+- **Purpose**: Notification service for *arr apps
+- **Uptime**: ~1.9 hours
+
+### Docker Hosts
+
+#### VMID 107 - dockge
+- **Node**: pm3
+- **CPU**: 12 cores
+- **Memory**: 8GB
+- **Disk**: 120GB (local-lvm)
+- **Status**: Running
+- **Tags**: proxmox-helper-scripts
+- **Features**: Unprivileged, nesting enabled
+- **Purpose**: Docker Compose management UI
+- **Uptime**: ~319 hours (~13 days)
+
+#### VMID 110 - docker-pm4
+- **Node**: pm4
+- **CPU**: 4 cores
+- **Memory**: 8GB
+- **Disk**: 10GB (local-lvm)
+- **Status**: Running
+- **Tags**: community-script, docker
+- **Features**: Unprivileged, nesting enabled
+- **Purpose**: Docker host
+- **Uptime**: ~45 hours
+
+#### VMID 113 - docker-pm2
+- **Node**: pm2
+- **CPU**: 4 cores
+- **Memory**: 8GB
+- **Disk**: 10GB (local-lvm)
+- **Status**: Running
+- **Tags**: community-script, docker
+- **Features**: Unprivileged, nesting enabled
+- **Purpose**: Docker host
+- **Uptime**: ~45 hours
+- **Notes**: Currently empty/minimal usage
+
+### Smart Home & IoT
+
+#### VMID 101 - twingate
+- **Node**: pm1
+- **CPU**: 1 core
+- **Memory**: 512MB
+- **Disk**: 8GB (local-lvm)
+- **Status**: Running
+- **Features**: Unprivileged
+- **Purpose**: Zero-trust network access
+- **Uptime**: ~52 hours
+
+#### VMID 102 - zwave-js-ui
+- **Node**: pm1
+- **CPU**: 2 cores
+- **Memory**: 1GB
+- **Disk**: 4GB (local-lvm)
+- **Status**: Running
+- **Tags**: proxmox-helper-scripts
+- **Features**: Unprivileged, nesting enabled
+- **Purpose**: Z-Wave device management
+- **Uptime**: ~52 hours
+
+### Surveillance & NVR
+
+#### VMID 103 - shinobi
+- **Node**: pm4
+- **CPU**: 2 cores
+- **Memory**: 2GB
+- **Disk**: 8GB (local-lvm)
+- **Status**: Running
+- **Tags**: community-script, nvr
+- **Features**: Unprivileged, nesting enabled
+- **Purpose**: Network Video Recorder
+- **Uptime**: ~52 hours
+- **Notes**: Very high network traffic (407GB in, 162GB out)
+
+#### VMID 111 - frigate
+- **Node**: pm3
+- **CPU**: 4 cores
+- **Memory**: 8GB
+- **Disk**: 120GB (local-lvm)
+- **Status**: Running
+- **Tags**: proxmox-helper-scripts
+- **Features**: Unprivileged, nesting enabled
+- **Purpose**: NVR with object detection
+- **Uptime**: ~18 hours
+- **Notes**: High storage and network usage
+
+### Gaming
+
+#### VMID 112 - foundryvtt
+- **Node**: pm3
+- **CPU**: 4 cores
+- **Memory**: 6GB
+- **Disk**: 100GB (local-lvm)
+- **Status**: Running
+- **Features**: Unprivileged, nesting enabled
+- **Purpose**: Virtual tabletop gaming platform
+- **Uptime**: ~116 hours (~5 days)
+
+## Summary Statistics
+
+- **Total Containers**: 21 (2 VMs + 19 LXCs)
+- **All Running**: Yes
+- **Total CPU Allocation**: 62 cores
+- **Total Memory Allocation**: 63.5GB
+- **Primary Storage**: KavNas (NFS) for most LXCs
+- **Most Active Node**: pm2 (11 containers)
+- **Newest Deployments**: Media stack on pm2 (mostly < 2 hours uptime)