FAQ & troubleshooting
1000+ specific problems and fixes for Saxon's homelab, money, and life setup. Search this section (Ctrl+K / ⌘K) or browse by category.
Written for anyone fixing things — including Ryan or family with zero prior knowledge. Each entry uses plain language and numbered fix steps.
How to use
- Search — type symptoms (
jellyfin black screen,offset,yubikey,pool degraded) - Pick a category below that matches where the problem seems to live
- Open the matching FAQ block — click the question to expand
- Follow steps in order — stop when fixed
- Escalate — if an entry says STOP or call a pro, do that
Before you change anything destructive
Read first
- Do not wipe TrueNAS pools, delete Cloudflare DNS, or factory-reset the router unless an FAQ explicitly says to.
- Passwords live in Vaultwarden — not in FAQ text.
- For death/handover: Guides → First 24 hours
Category map
| Category | File | ID prefix | Covers |
|---|---|---|---|
| Network (general) | Network general | NET | LAN, IPs, CGNAT, basic connectivity |
| UniFi & Wi‑Fi | UniFi & Wi‑Fi | UNI | Dream Machine SE, APs, SSIDs, Wi‑Fi |
| DNS & domains | DNS & domains | DNS | saxobroko.com, records, propagation |
| Cloudflare edge | Cloudflare edge | CFL | WAF, SSL, Pages, Access, Bot Fight |
| Cloudflare tunnel | Cloudflare tunnel | TUN | cloudflared, tunnel outages, hostnames |
| TrueNAS pool | TrueNAS pool | NAS | Pool health, imports, upgrades |
| TrueNAS apps | TrueNAS apps & Docker | DKR | Apps, restarts, ports, updates |
| Storage & SMART | Storage & SMART | STG | Disks, scrubs, space, errors |
| Backups & recovery | Backups & recovery | BAK | Restore, snapshots, off-site |
| Power & hardware | Power & hardware | PWR | Outages, UPS, physical gear |
| Jellyfin playback | Jellyfin playback | JFY | Streaming, transcoding, clients |
| Jellyfin library | Jellyfin library | JFL | Scans, metadata, missing media |
| *arr automation | Sonarr / Radarr / Lidarr | ARR | TV, movies, music pipeline |
| Prowlarr & indexers | Prowlarr & indexers | PRW | Indexers, caps, failures |
| qBittorrent | qBittorrent & downloads | QBT | Torrents, paths, stuck jobs |
| Overseerr | Overseerr & requests | OVR | Requests, approvals, sync |
| Navidrome & music | Navidrome & music | NAV | Music streaming, library |
| Photos | Photos app | PHO | Photo library, sharing |
| Authentik & SSO | Authentik & SSO | AUTH | Login, providers, tokens |
| Vaultwarden | Vaultwarden / Bitwarden | VLT | Passwords, sync, unlock |
| YubiKey & 2FA | YubiKey & 2FA | YUB | Hardware keys, WebAuthn |
| Windows PC | Windows PC | WIN | Client PC, drive A:, gaming |
| Finance & banking | Finance & banking | FIN | MyState, offset, Vanguard, bills |
| Subscriptions | Subscriptions & bills | SUB | Prime, phone, insurance, Greenfleet |
| Public sites | Public sites | PUB | saxobroko.com, status, weather |
| SaxDocs & GitHub | SaxDocs & GitHub | DOC | This site, deploy, edit |
| Handover & life | Handover & life events | LIF | Death, will, McDonald's, utilities |
| Homepage & dash | Homepage dashboard | DSH | dash.saxobroko.com tiles |
| NPM & reverse proxy | NPM proxy | NPM | Nginx Proxy Manager |
| Plex legacy | Plex legacy | PLX | Old Plex setup |
| Edge cases & misc | Edge cases & misc | MSC | Everything else |
Related runbooks
- Guides — step-by-step for beginners
- Common Issues — shorter server runbook
- Monitoring — status.saxobroko.com