Skip to content

FAQ & troubleshooting

1200+ deep troubleshooting entries wired into Server, Guides, Finance, and Personal docs — not standalone bullet lists.

Start here (integrated)

I need to… Open
Match a symptom to fixes Symptom finder
See which URL / service broke Service matrix
Outage — work top-down Outage runbook
Media request → watch pipeline Media pipeline
Login / Access / Vault / YubiKey Auth stack
Money / bills / handover Finance troubleshooting

Search (Ctrl+K / ⌘K): symptoms, FAQ IDs (NET-003, JFY-001), or hostnames (stream.saxobroko.com).

What each FAQ entry includes

Every ??? question block in category files now carries:

Section Purpose
Stack context Where this fits (TrueNAS, Cloudflare, MyState, …)
Integrated runbooks Links to hubs + Server docs
Why this happens Root cause in plain language (when known)
Diagnose (2 min) LAN vs public, service matrix, second device check
Symptoms / Fix What you see and numbered steps
Verify Confirm the fix actually worked
Deep dive Guide or Server page for full architecture

Category files below hold all NET/JFY/AUTH/etc. entries. Hubs above group them by workflow.

How to use

  1. Try an integrated runbook first if the scenario matches (outage, media, auth, money).
  2. Otherwise open Symptom finder or search.
  3. Expand the FAQ block — follow steps in order.
  4. Use Verify before closing the tab.
  5. Follow Deep dive if you need setup context, not just a fix.

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.
  • Pool DEGRADEDserver-when-pool-degraded before any disk work.
  • Death/handover → First 24 hours

Category files (all entries)

Category File IDs
Network general network-general.md NET
UniFi & Wi‑Fi unifi-wifi.md UNI
DNS & domains dns-domains.md DNS
Cloudflare edge cloudflare-edge.md CFL
Cloudflare tunnel cloudflared-tunnel.md TUN
TrueNAS pool truenas-pool.md NAS
TrueNAS apps truenas-apps-docker.md DKR
Storage & SMART storage-smart-scrub.md STG
Backups backups-recovery.md BAK
Power & hardware power-outage-hardware.md PWR
Jellyfin playback jellyfin-playback.md JFY
Jellyfin library jellyfin-library.md JFL
*arr stack arr-sonarr-radarr.md ARR
Prowlarr prowlarr-indexers.md PRW
qBittorrent qbittorrent-downloads.md QBT
Overseerr overseerr-requests.md OVR
Navidrome navidrome-music.md NAV
Photos photos-app.md PHO
Plex legacy plex-legacy-faq.md PLX
Authentik authentik-sso.md AUTH
Vaultwarden vaultwarden-bitwarden.md VLT
YubiKey yubikey-login.md YUB
Windows PC windows-pc.md WIN
Finance finance-money.md FIN
Subscriptions subscriptions-bills.md SUB
Handover handover-life.md LIF
Public sites public-sites-faq.md PUB
SaxDocs saxdocs-github.md DOC
Homepage homepage-dashboard.md DSH
NPM npm-proxy.md NPM
Edge cases edge-cases-misc.md MSC