Skip to content

Improvements Identified - 2026-01-15

Comprehensive codebase review after completing hardware documentation.

Critical (Fix Now)

  • [x] 1. Update architecture-review.md domains
  • File: docs/architecture-review.md
  • Issue: References old domains (nanduti.io, verava.net)
  • Action: Update to cronova.dev + verava.ai
  • Lines: 130-484 (Domain Coexistence Strategy, Caddyfile examples, costs)

  • DONE: Replaced all domain references, updated costs

  • [x] 2. Fix Frigate location in services.md

  • File: docs/services.md:77
  • Issue: Lists Frigate under NAS services
  • Action: Move to Docker VM, NAS only exports NFS
  • DONE: Moved Frigate to Docker VM, added NFS export to NAS

High Priority

  • [x] 3. Create fixed homelab docker-compose files (Docker VM)
  • Missing: docker/fixed/docker-vm/
  • Services needed:
    • networking/pihole/docker-compose.yml
    • networking/caddy/docker-compose.yml
    • media/docker-compose.yml (Jellyfin, Sonarr, Radarr, Prowlarr, qBittorrent)
    • automation/docker-compose.yml (Home Assistant, Mosquitto)
    • security/docker-compose.yml (Vaultwarden, Frigate)

  • DONE: Created all 5 docker-compose files with documentation

  • [x] 4. Create fixed homelab docker-compose files (NAS)

  • Missing: docker/fixed/nas/
  • Services needed:
    • storage/docker-compose.yml (Samba, Syncthing)
    • backup/docker-compose.yml (Restic REST)
    • NFS export configuration
  • DONE: Created storage and backup docker-compose files with NFS instructions

Medium Priority

  • [x] 5. Resolve port 8080 conflict
  • File: docs/services.md:121
  • Issue: qBittorrent and Pi-hole alt both use 8080
  • Decision needed: qBittorrent→6881 or Pi-hole alt→8053
  • Note: VPS already uses 8053 for Pi-hole

  • DONE: No conflict - VPS Pi-hole already uses 8053, updated docs

  • [x] 6. Document NUT (UPS graceful shutdown)

  • Files: hardware.md:292, fixed-homelab.md:474
  • Issue: Marked TODO, not implemented
  • Action: Add NUT configuration to NAS docker-compose or system config

  • DONE: Created docs/nut-config.md with full NUT setup

  • [x] 7. Create monitoring strategy document

  • Missing: Uptime Kuma checks + ntfy notifications
  • Content needed:
    • Service monitor list
    • ntfy topic configuration
    • Alert thresholds

  • DONE: Created docs/monitoring-strategy.md

  • [x] 8. Create VLAN documentation

  • Missing: OPNsense IoT isolation strategy
  • Content needed:
    • VLAN design (IoT, Guest, Management)
    • Firewall rules between VLANs
    • Camera isolation

  • DONE: Created docs/vlan-design.md

  • [x] 9. Create backup test procedure

  • Missing: Validation that DR runbook works
  • Content needed:
    • Monthly restore test checklist
    • Backup verification steps
    • Test result documentation

  • DONE: Created docs/backup-test-procedure.md

  • [x] 10. Document certificate strategy

  • File: docs/caddy-config.md:402-421
  • Issue: Two options listed, no decision made
  • Decision needed: Tailscale HTTPS vs Internal CA
  • DONE: Created docs/certificate-strategy.md (chose Tailscale HTTPS)

Low Priority

  • [x] 11. Archive or update domain-research.md
  • File: docs/domain-research.md
  • Issue: References superseded domains (nanduti.io, verava.net)
  • Action: Add notice that it's superseded by domain-strategy.md

  • DONE: Added archive notice at top of file

  • [x] 12. Document NAS PSU model

  • File: docs/hardware.md:145
  • Issue: Still TBD
  • Action: Verify and document actual PSU model
  • DONE: picoPSU-160-XT + 220W brick (192W DC-DC, 2013)

Progress Tracking

# Task Status Commit

| 1 | Update architecture-review.md domains | Done | ef92139 | | 2 | Fix Frigate location in services.md | Done | ef92139 | | 3 | Docker VM docker-compose files | Done | bc86158 | | 4 | NAS docker-compose files | Done | bc86158 | | 5 | Port 8080 conflict | Done | (pending) | | 6 | NUT configuration | Done | (pending) | | 7 | Monitoring strategy | Done | (pending) | | 8 | VLAN documentation | Done | (pending) | | 9 | Backup test procedure | Done | (pending) | | 10 | Certificate strategy | Done | (pending) | | 11 | Archive domain-research.md | Done | (pending) | | 12 | NAS PSU model | Done | (pending) |

Session Notes

Started: 2026-01-15 Focus: Fix critical/high items first, then medium priority