Changelog¶
Tracks all significant documentation and infrastructure changes.
Format¶
## YYYY-MM-DD
- **[Type]** Description โ [link to affected doc](path/to/doc.md)
Types: Added ยท Updated ยท Removed ยท Fixed ยท Infrastructure
Log¶
2026-04-27¶
- [Fixed] Lotus server doc โ Immich storage layout documented; corrected LuckyBackup source path from
/mnt/user/data/media/immich/to/mnt/user/immich/; backup table updated with correct paths - [Added] Lessons Learned โ LuckyBackup was silently backing up wrong Immich path for 9+ months; lesson: verify backup source paths match actual container mounts after any volume reconfiguration
2026-04-25 (continued further)¶
- [Infrastructure] Lotus server doc, Cooper server doc, Services, Current State โ Immich PostgreSQL streaming replication set up:
replicatorrole created on Lotus, pg_hba.conf updated, pg_basebackup run to seed Cooper replica,immich-pg-relaysocat container on Lotus exposes host:5452 โ immich_postgreSQL:5432,immich-postgres-replicacontainer running on Cooper as streaming standby - [Added] Lessons Learned โ Unraid CA port mapping cannot be safely edited; use socat relay on the same Docker network instead
2026-04-25 (continued)¶
- [Infrastructure] Network, Inventory โ backup internet connection added: Three LTE SIM in Zyxel LTE3302-M432 connected to UCG Ultra port 4 as WAN2; failover-only mode with health checks pinging 8.8.8.8 and 1.1.1.1; left in router mode to preserve management access at 192.168.2.254
2026-04-25¶
- [Infrastructure] Inventory, Cooper server doc โ 512GB SSD added to Cooper bay 4 as cache pool
- [Infrastructure] Cooper server doc โ added SWAG standby instance; documented hourly rsync from Lotus and Tailscale folder exclusion requirement
- [Updated] Services โ added Cooper infrastructure section with SWAG entry
- [Updated] Current State โ added SWAG to Cooper service list
- [Added] Lessons Learned โ rsyncing SWAG appdata caused Tailscale node ID conflict; exclude
/appdata/swag/.tailscale_state/from all appdata sync jobs - [Infrastructure] Network, Cooper server doc โ SWAG hot spare completed; automatic failover script running on Cooper every 5 minutes; Cloudflare DNS flips to Cooper (100.126.183.94) after 2 consecutive failures and fails back automatically on recovery
- [Infrastructure] Network โ Cloudflare DNS consolidated from 29 individual A records to a single
*.djchome.ukwildcard;docs.djchome.ukretained as specific record (Cloudflare Pages) - [Fixed] Lessons Learned โ corrected Tailscale state directory path from
tailscale/to.tailscale_state/
2026-04-15¶
- [Updated] After a Power Cut, Internet Is Down, Home Assistant Is Down โ added Router-Modem_Pacific.jpg (wardrobe overview), UCG-normal-display.jpg (router screen), PacificNUC-blueNormal.jpg (blue light state) to relevant pages
- [Updated] After a Power Cut โ Step 1 expanded with UPS flat scenario; Step 2 rewritten as internet/WiFi check (2SVT-Main, internet-down link); Step 3 rewritten with Pacific light states table, orange-more-than-once escalation path, Lotus 5-min/beep note, Cooper "not essential" note, closing reassurance line
- [Updated] Home Assistant Is Down โ "Migrate HA to Unraid" video embedded in Step 3; Step 2 cross-references it
- [Updated] Backup Strategy โ restore time added to HA backup methods: ~45 min (HA built-in / Lotus) and ~90 min (PBS full VM / Pacific)
- [Updated] Network โ Physical Setup expanded with switch topology diagram; Switches and Access Points & WiFi sections added (with SSID table); Key IP Addresses table updated with switches, APs, docs.home, gabriela.home; Documentation Access table corrected (local docs live at 192.168.1.81)
- [Fixed] Internet Is Down โ Vodafone icon switched from elax46 (404) to Simple Icons; "Contact Dan" โ "Contact Daniel"
- [Updated] Partner Guide โ gabriela.home, docs.djchome.uk, and docs.home made clickable links
- [Updated] Home Assistant Is Down โ full rewrite: Step 1 retitled and cellular wording added; Step 2 replaced with Pacific power button light guide (off/orange/blue); Step 3 added for backup HA on Lotus with safety warning; Proxmox login video added
- [Updated] Living Room Wall Panel โ photos removed (video covers it better), text steps kept
- [Updated] Common Issues โ doorbell section rewritten: correct WiFi-not-internet dependency, chime reset step, Reolink page check; removed incorrect Frigate/Pacific info
- [Updated] Hardware Inventory โ NUC6CAYH model added to Pacific
- [Added] Internet Is Down โ dedicated partner page extracted from common-issues
- [Added] Home Assistant Is Down โ dedicated partner page
- [Added] Lights & Smart Devices โ dedicated partner page covering single devices, motion sensors (USB + Hue AAA), blind (charge + limit reset), and Zigbee-wide outages
- [Added] Central Heating โ dedicated partner page covering Shelly, TRVs, and manual overrides
- [Updated] Partner Guide โ reordered What's Broken table by likelihood, removed restart sections, links to new individual pages
- [Updated] Common Issues โ reduced to minor/catch-all issues (Plex, doorbell, alarm, noises)
- [Updated] After a Power Cut โ emoji step headings, clickable IP links, Proxmox brand icon
- [Updated] Living Room Wall Panel โ Shelly brand icon on page title
- [Updated] Zigbee Bridge Fix โ Zigbee brand icon on page title
- [Updated] All partner pages โ "Dan" โ "Daniel" throughout; all bare IPs and URLs made clickable (
target="_blank"); brand icons added from elax46 and Simple Icons (Home Assistant, Shelly, Philips Hue, Zigbee, Proxmox, Plex, Sonoff, Vodafone, UniFi, Ring, Alexa); icons sized at1.1emto match emoji scale - [Updated]
mkdocs.ymlโ new partner pages added to navigation - [Added]
.claude/launch.jsonโ MkDocs dev server configuration
2026-04-14¶
- [Infrastructure] Gabriela's dashboard live โ http://gabriela.home (gethomepage on 192.168.1.82:3000, proxied via docs nginx on 192.168.1.81)
- [Updated] docs nginx config to proxy gabriela.home alongside serving docs.home
- [Updated] Current State and Quick Reference โ gabriela-homepage container and IP documented
- [Updated] Gabriela's dashboard โ Help Guide link points to http://docs.home/partner/ (direct to partner section); added Audiobookshelf, Immich, Mealie, Reolink doorbell
- [Infrastructure] Local docs site live โ http://docs.home (192.168.1.81, nginx:alpine on Lotus, br0 network, syncs from GitHub every 30 min)
- [Added] DNS record
docs.home โ 192.168.1.81added to UniFi UCG Ultra - [Added] Container icon added to repo at
docs/assets/homelab-docs.png - [Updated] Partner Guide โ added local docs URL and http:// tip
- [Updated] Quick Reference โ local docs URL, Cooper UPS fix, 192.168.1.81 added to device IPs
- [Updated] Current State โ homelab-docs container added to Lotus services
- [Updated]
CLAUDE.mdโ local docs URL and sync method documented - [Added] Common Issues โ central heating (Shelly Plus2PM), Sonoff TRVZB section, Ring alarm system, Vodafone outage checker
- [Updated] Common Issues โ Plex section leads with Lotus location check
- [Added] Boiler overview video and plug socket photo to central heating section
- [Added] Shelly web interface screenshots (direct WiFi connection steps)
2026-04-13¶
- [Added] Initial homelab documentation setup โ all core docs populated with real data
- [Added] Hardware Inventory โ Lotus, Cooper, Pacific, Brabham, network equipment, smart home devices
- [Added] Network โ VLANs, WAN, DNS, Tailscale/SWAG external access, domain setup
- [Added] Current State โ all running services across all hosts
- [Added] Quick Reference โ IPs, URLs, SSH commands, backup schedule
- [Added] Primary NAS โ Lotus โ server doc
- [Added] Backup NAS โ Cooper โ server doc
- [Added] Proxmox NUC โ Pacific โ server doc
- [Added] Services Overview โ all services grouped by host and function
- [Added] Partner Guide โ Gabriela-facing landing page
- [Added] After a Power Cut โ step-by-step plain English recovery guide
- [Added] Common Issues โ plain English decision tree for common problems
- [Updated]
CLAUDE.mdโ replaced setup placeholders with real hostnames, IPs, and network context - [Updated]
mkdocs.ymlโ updated site name to "Dan's Homelab", removed unused service stubs - [Infrastructure] Created
.setup-completemarker โ setup mode disabled