Common Issues

Problems that come up with the homelab, and what actually fixes them.

FAQ integration (start here for depth)

This page is the short runbook. For step-by-step fixes with stack context, diagnosis, and links to Guides:

Scenario	Integrated FAQ hub
Something broke — don't know where	Symptom finder
Outage / many sites down	Outage runbook
Which URL maps to which app	Service matrix
Media request → watch pipeline	Media pipeline troubleshooting
Login / Access / Vault / YubiKey	Auth stack troubleshooting
Money / bills / handover	Finance troubleshooting

Search 1200+ entries: FAQ index (Ctrl+K / ⌘K).

---

Can't reach a .saxobroko.com site

1. Check if it works on the LAN first (TrueNAS app port or local URL)
2. Confirm Cloudflare Tunnel is running on TrueNAS / wherever cloudflared lives
3. Check Cloudflare DNS points at the tunnel, not old local.saxobroko.com CNAME
4. Check WAF rules (block no aus) — from outside Australia you will get 403 by design on most hosts
5. Check the hostname is in localnet full strict ssl if SSL errors appear

Deep FAQ: Outage runbook — LAN vs public · TUN-* · CFL-*

Can't reach a site from outside Australia

Expected for most homelab apps. block no aus is intentional. SaxDocs is the exception (public unless Cloudflare Access is enabled).

TrueNAS / dsm not loading

1. Can you ping 192.168.2.203 on LAN?
2. Try dsm.saxobroko.com — is the tunnel up?
3. Check TrueNAS is powered on (IPMI or physical check)

Mapped drive (A:) missing

Re-map it. See Windows network drive. Confirm SMB is enabled on TrueNAS.

Jellyfin not showing new media

1. Files in the right folder on A:/Media? Adding media
2. Correct folder naming?
3. Trigger library scan in Jellyfin or restart the TrueNAS app

Deep FAQ: Media pipeline — stage 4 · JFL-* · ARR-*

Photos not uploading from iPhone

1. App logged in?
2. Background refresh enabled?
3. Leave on Wi‑Fi — large libraries take time

Homepage / dash shows login instead of dashboard

Authentik is in front of it. Sign in via auth.saxobroko.com. Credentials in Vaultwarden.

SaxDocs outdated or down

Built on push to main → Cloudflare Pages. Check GitHub Actions and Pages deploy logs. See This docs site.

Authentik login loops

OIDC callback URLs must not be blocked by Cloudflare Access. See Authentik.

Deep FAQ: Auth stack troubleshooting · AUTH-*

~~Storj node won't start~~

Retired — CGNAT. See Storj (archived).