Photos app
Troubleshooting photos.saxobroko.com on TrueNAS — likely Immich. See Photos server doc.
PHO-001: photos.saxobroko.com won't load?
- Check internet and Australia location.
- Tunnel down — restart cloudflared.
- TrueNAS photos app running.
- LAN app port on 192.168.2.203 if tunnel up but public fails.
PHO-002: iPhone uploads stuck?
- Logged in Immich or matching app?
- Background app refresh on.
- Wi‑Fi only for bulk — large library.
- See Server/common-issues photos section.
PHO-003: Photos missing after migration from Synology?
- Verify app library path points migrated dataset not empty volume.
- Immich first-run may have created new empty dir.
- Fix path in TrueNAS app config.
- Rescan or re-index library.
PHO-004: Uploads very slow?
- Expected for tens of thousands of photos.
- Keep app foreground first hour iOS.
- NAS CPU generating thumbnails.
- Overnight Wi‑Fi upload.
PHO-005: Duplicate photos appearing?
- Immich dedupe by hash usually.
- Same photo uploaded twice different devices.
- Merge duplicates in app if feature exists.
- Check sync from multiple accounts.
PHO-006: Cannot login photos site?
- Credentials Vaultwarden.
- Authentik if in front — auth.saxobroko.com.
- Separate from Jellyfin login.
- Reset via TrueNAS app admin if locked.
PHO-007: Thumbnails blurry or missing?
- Background job still processing.
- Wait hours after large import.
- Check disk space for thumbnail cache.
- Restart app if stuck days.
PHO-008: Out of storage during upload?
- Photos dataset full — check TrueNAS pool.
- Free space before bulk upload.
- RAIDZ1 one disk margin — urgent if degraded.
- Pause uploads until space fixed.
PHO-009: HEIC photos not displaying?
- Immich supports HEIC typically.
- Verify transcoding settings in app.
- Update app version.
- Convert HEIC rare last resort.
PHO-010: Live Photos support?
- Immich handles Live Photos iOS.
- May store photo plus video component.
- Check client playback.
- Large upload size normal.
PHO-011: Shared album with family?
- Immich sharing features — create album invite.
- Separate user accounts recommended.
- Public link may geo-block non-AU.
- Credentials not in SaxDocs.
PHO-012: Android upload app?
- Immich Android from store if Immich deployed.
- Server URL https://photos.saxobroko.com
- Same as iOS workflow.
- Verify app name in TrueNAS Apps.
PHO-013: Which app is installed Immich or other?
- TrueNAS → Apps → check installed name.
- Server photos.md says likely Immich.
- Client must match server.
- Update SaxDocs if different app.
PHO-014: Photos on LAN without tunnel?
- Direct to NAS app port.
- Find port in TrueNAS app details.
- Same login.
- Use when cloudflared down.
PHO-015: Deleted photo still in Google?
- Google Photos separate — not synced back.
- This stack is self-hosted only.
- Delete Google copy manually if desired.
- One-way migration history.
PHO-016: Backup photos where?
- ZFS snapshots on photos dataset.
- Off-site TODO in photos.md.
- Takeout copy may exist externally.
- Pool loss loses photos — prioritize backups.
PHO-017: App update broke gallery?
- Snapshot before updates.
- Check Immich release notes migration.
- Wait for re-index after upgrade.
- Rollback app version if broken.
PHO-018: Video clips in timeline?
- Immich shows motion photos and videos.
- Large files slow timeline.
- Filter media type in UI.
- Normal mixed library.
PHO-019: Search faces not working?
- ML feature may need enable and time.
- CPU load on NAS.
- Privacy local processing.
- Optional not required browse.
PHO-020: Map view empty?
- GPS EXIF in photos.
- Old scans without location show nothing.
- Enable location on camera for new.
- Privacy strip location optional export.
PHO-021: Download original from web?
- Immich download button per asset.
- Bulk export admin feature.
- Large zip takes time.
- Use for backup verify.
PHO-022: Two-factor for photos?
- If Authentik in front — YubiKey flow.
- App native login may be separate.
- Check access stack.
- Vaultwarden for passwords.
PHO-023: Upload from Windows PC?
- Web upload or sync client if Immich supports.
- Bulk via mobile usually easier.
- Network path not typical drive letter.
- Browser drag drop small batches.
PHO-024: Permissions error upload?
- User quota or disk full.
- App container write ACL on dataset.
- Technical fix dataset permissions.
- Retry after fix.
PHO-025: Photos app red on dash?
- Service down — restart app TrueNAS.
- Pool issue.
- Tunnel if only public fails.
- dash.saxobroko.com diagnostic.
PHO-026: Slow first open after login?
- Large library pagination.
- CDN cache not used — direct tunnel.
- Normal.
- Subsequent pages faster.
PHO-027: Timezone wrong on timestamps?
- Server timezone Australia/Melbourne.
- EXIF vs upload time display toggle.
- Immich settings.
- Cosmetic sorting.
PHO-028: RAW photos from camera?
- May need conversion for web view.
- Immich RAW support version dependent.
- JPEG sidecar or convert.
- Large storage use.
PHO-029: Partner cannot see shared album?
- Invite accepted?
- Same geo restrictions.
- User account exists.
- Re-share link.
PHO-030: Rate limit or 403 outside Australia?
- block no aus WAF intentional.
- Connect from Australia or home network.
- VPN AU endpoint if must.
- Same as Jellyfin geo.
PHO-031: Immich server version mismatch app?
- Update mobile app from store.
- Server update via TrueNAS.
- Version skew breaks upload API.
- Match versions per Immich docs.
PHO-032: External drive import?
- Copy to dataset then scan.
- USB to NAS import — technical.
- Not via Windows A: typically.
- One-time migration path.
PHO-033: Pool scrub during upload?
- Heavy IO may slow uploads.
- Upload still works.
- Schedule scrub off-peak.
- Not harmful together.
PHO-034: Logout all devices?
- Change password admin.
- Revoke sessions in app if available.
- Security after lost phone.
- Vaultwarden update password.
PHO-035: Photos vs Jellyfin for home videos?
- Home videos may belong photos Immich.
- Jellyfin for commercial Movies Shows.
- Personal clips Immich better.
- Do not mix libraries blindly.