Skip to content

Improvement Plan - 2026-01-16

Comprehensive codebase review findings and action plan.

Summary

Priority Count Status

| Critical | 7 | Complete | | High | 5 | Complete | | Medium | 12 | Complete | | Total|24|24 done |

Critical Priority (Blocks Deployment)

Must be fixed before any deployment attempt.

# Issue Location Status

| 1 | Missing frigate.yml config | docker/fixed/docker-vm/security/ | [x] | | 2 | Missing mosquitto.conf | docker/fixed/docker-vm/automation/ | [x] | | 3 | Missing Caddyfile (fixed homelab) | docker/fixed/docker-vm/networking/caddy/ | [x] | | 4 | Missing htpasswd for Restic REST (NAS) | docker/fixed/nas/backup/ | [x] | | 5 | Missing htpasswd for Restic REST (VPS) | docker/vps/backup/ | [x] | | 6 | Mobile Headscale deprecated | docker/mobile/rpi5/networking/headscale/ | [x] | | 7 | Port 80 conflict: Pi-hole → 8053 | docker/fixed/docker-vm/networking/ | [x] |

High Priority (Incomplete Setup)

Complete before testing services.

# Issue Location Status

| 8 | Missing .env.example files | All docker directories | [x] | | 9 | Docker network isolation undefined | docker/README.md | [x] | | 10 | Headscale config/config.yaml template | docker/vps/networking/headscale/config/ | [x] | | 11 | NFS mount procedure not documented | docs/nfs-setup.md | [x] | | 12 | OPNsense setup guide missing | docs/opnsense-setup.md | [x] |

Medium Priority (Documentation Gaps)

Complete before production use.

# Issue Location Status

| 13 | qBittorrent port conflict (8080 vs 6881) | docs/services.md | [x] | | 14 | NAS symlink creation not documented | docs/fixed-homelab.md | [x] | | 15 | Uptime Kuma monitors not seeded | docker/vps/monitoring/monitors.md | [x] | | 16 | Backup verification script not deployed | scripts/backup-verify.sh | [x] | | 17 | Service matrix (what runs where) missing | docs/services.md | [x] | | 18 | Setup runbook for fresh deployment | docs/setup-runbook.md | [x] | | 19 | Proxmox setup guide missing | docs/proxmox-setup.md | [x] | | 20 | TLS/SSL strategy in compose vs docs | Caddyfile updated | [x] | | 21 | Tailscale IP allocation policy | docs/hardware.md | [x] | | 22 | Ansible playbooks referenced but empty | ansible/ | [x] | | 23 | Top-level README needs navigation | README.md | [x] | | 24 | Docker directory README missing | docker/README.md | [x] |

Action Plan

Phase 1: Critical Config Files (Complete)

  1. ~~Create frigate.yml - camera configuration template~~
  2. ~~Create mosquitto.conf - MQTT broker config~~
  3. ~~Create Caddyfile for fixed homelab~~
  4. ~~Document htpasswd creation for Restic REST~~
  5. ~~Deprecate mobile Headscale (moved to VPS)~~
  6. ~~Resolve port 80 conflict (Pi-hole → 8053)~~

Phase 2: Environment Templates (Complete)

  1. ~~Create .env.example for all docker directories~~ (14 files)
  2. ~~Document Docker network strategy~~ (docker/README.md)
  3. ~~Create Headscale config.yaml template~~ (config/config.yaml.example)
  4. ~~Create NFS setup guide~~ (docs/nfs-setup.md)
  5. ~~Create OPNsense setup guide~~ (docs/opnsense-setup.md)

Phase 3: Remaining Medium Priority (Future)

  1. Proxmox setup guide
  2. Setup runbook (full deployment)
  3. qBittorrent port conflict resolution
  4. Service matrix documentation
  5. Uptime Kuma monitor seeding
  6. Backup verification scripts

Phase 4: Polish (Future)

  1. Tailscale IP allocation policy
  2. Ansible playbooks
  3. Top-level README improvements
  4. Docker directory README

Notes

  • VPS Headscale docker-compose and backup.sh already created (2026-01-16)
  • Network diagram with both switches completed (2026-01-16)
  • VLAN design documented with port assignments
  • Mobile kit now on-demand operation (Headscale moved to VPS)
  • docs/sessions/2026-01-16.md - Session summary
  • docs/sessions/improvements-2026-01-15.md - Previous improvements (all complete)