Skip to content

Photos app

Troubleshooting photos.saxobroko.com on TrueNAS — likely Immich. See Photos server doc.

PHO-001: photos.saxobroko.com won't load?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Check internet and Australia location.
  2. Tunnel down — restart cloudflared.
  3. TrueNAS photos app running.
  4. LAN app port on 192.168.2.203 if tunnel up but public fails. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-002: iPhone uploads stuck?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Logged in Immich or matching app?
  2. Background app refresh on.
  3. Wi‑Fi only for bulk — large library.
  4. See Server/common-issues photos section. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-003: Photos missing after migration from Synology?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Verify app library path points migrated dataset not empty volume.
  2. Immich first-run may have created new empty dir.
  3. Fix path in TrueNAS app config.
  4. Rescan or re-index library. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-004: Uploads very slow?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Expected for tens of thousands of photos.
  2. Keep app foreground first hour iOS.
  3. NAS CPU generating thumbnails.
  4. Overnight Wi‑Fi upload. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-005: Duplicate photos appearing?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Immich dedupe by hash usually.
  2. Same photo uploaded twice different devices.
  3. Merge duplicates in app if feature exists.
  4. Check sync from multiple accounts. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-006: Cannot login photos site?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Credentials Vaultwarden.
  2. Authentik if in front — auth.saxobroko.com.
  3. Separate from Jellyfin login.
  4. Reset via TrueNAS app admin if locked. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-007: Thumbnails blurry or missing?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Background job still processing.
  2. Wait hours after large import.
  3. Check disk space for thumbnail cache.
  4. Restart app if stuck days. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-008: Out of storage during upload?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Photos dataset full — check TrueNAS pool.
  2. Free space before bulk upload.
  3. RAIDZ1 one disk margin — urgent if degraded.
  4. Pause uploads until space fixed. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-009: HEIC photos not displaying?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Immich supports HEIC typically.
  2. Verify transcoding settings in app.
  3. Update app version.
  4. Convert HEIC rare last resort. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-010: Live Photos support?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Immich handles Live Photos iOS.
  2. May store photo plus video component.
  3. Check client playback.
  4. Large upload size normal. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-011: Shared album with family?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Immich sharing features — create album invite.
  2. Separate user accounts recommended.
  3. Public link may geo-block non-AU.
  4. Credentials not in SaxDocs. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-012: Android upload app?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Immich Android from store if Immich deployed.
  2. Server URL https://photos.saxobroko.com
  3. Same as iOS workflow.
  4. Verify app name in TrueNAS Apps. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-013: Which app is installed Immich or other?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. TrueNAS → Apps → check installed name.
  2. Server photos.md says likely Immich.
  3. Client must match server.
  4. Update SaxDocs if different app. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-014: Photos on LAN without tunnel?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Direct to NAS app port.
  2. Find port in TrueNAS app details.
  3. Same login.
  4. Use when cloudflared down. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-015: Deleted photo still in Google?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Google Photos separate — not synced back.
  2. This stack is self-hosted only.
  3. Delete Google copy manually if desired.
  4. One-way migration history. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-016: Backup photos where?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. ZFS snapshots on photos dataset.
  2. Off-site TODO in photos.md.
  3. Takeout copy may exist externally.
  4. Pool loss loses photos — prioritize backups. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-017: App update broke gallery?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Snapshot before updates.
  2. Check Immich release notes migration.
  3. Wait for re-index after upgrade.
  4. Rollback app version if broken. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-018: Video clips in timeline?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Immich shows motion photos and videos.
  2. Large files slow timeline.
  3. Filter media type in UI.
  4. Normal mixed library. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-019: Search faces not working?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. ML feature may need enable and time.
  2. CPU load on NAS.
  3. Privacy local processing.
  4. Optional not required browse. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-020: Map view empty?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. GPS EXIF in photos.
  2. Old scans without location show nothing.
  3. Enable location on camera for new.
  4. Privacy strip location optional export. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-021: Download original from web?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Immich download button per asset.
  2. Bulk export admin feature.
  3. Large zip takes time.
  4. Use for backup verify. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-022: Two-factor for photos?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. If Authentik in front — YubiKey flow.
  2. App native login may be separate.
  3. Check access stack.
  4. Vaultwarden for passwords. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-023: Upload from Windows PC?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Web upload or sync client if Immich supports.
  2. Bulk via mobile usually easier.
  3. Network path not typical drive letter.
  4. Browser drag drop small batches. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-024: Permissions error upload?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. User quota or disk full.
  2. App container write ACL on dataset.
  3. Technical fix dataset permissions.
  4. Retry after fix. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-025: Photos app red on dash?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Service down — restart app TrueNAS.
  2. Pool issue.
  3. Tunnel if only public fails.
  4. dash.saxobroko.com diagnostic. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-026: Slow first open after login?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Large library pagination.
  2. CDN cache not used — direct tunnel.
  3. Normal.
  4. Subsequent pages faster. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-027: Timezone wrong on timestamps?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Server timezone Australia/Melbourne.
  2. EXIF vs upload time display toggle.
  3. Immich settings.
  4. Cosmetic sorting. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-028: RAW photos from camera?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. May need conversion for web view.
  2. Immich RAW support version dependent.
  3. JPEG sidecar or convert.
  4. Large storage use. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-029: Partner cannot see shared album?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Invite accepted?
  2. Same geo restrictions.
  3. User account exists.
  4. Re-share link. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-030: Rate limit or 403 outside Australia?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. block no aus WAF intentional.
  2. Connect from Australia or home network.
  3. VPN AU endpoint if must.
  4. Same as Jellyfin geo. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-031: Immich server version mismatch app?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Update mobile app from store.
  2. Server update via TrueNAS.
  3. Version skew breaks upload API.
  4. Match versions per Immich docs. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-032: External drive import?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Copy to dataset then scan.
  2. USB to NAS import — technical.
  3. Not via Windows A: typically.
  4. One-time migration path. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-033: Pool scrub during upload?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Heavy IO may slow uploads.
  2. Upload still works.
  3. Schedule scrub off-peak.
  4. Not harmful together. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-034: Logout all devices?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Change password admin.
  2. Revoke sessions in app if available.
  3. Security after lost phone.
  4. Vaultwarden update password. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics
PHO-035: Photos vs Jellyfin for home videos?

Stack context: Photos @ photos.saxobroko.com · TrueNAS dataset Integrated runbooks: photos · Service matrix

Diagnose (2 min): 1. Confirm whether the problem is LAN-only, public URL, or both — see Outage runbook. 2. Check Service matrix for which app/host owns the broken URL. 3. If a single device only, retry from a second device on the same network.

  1. Home videos may belong photos Immich.
  2. Jellyfin for commercial Movies Shows.
  3. Personal clips Immich better.
  4. Do not mix libraries blindly. Verify: Repeat the original symptom check — it should be gone or clearly improved. Deep dive: Photos basics