Troubleshooting category
Photo Backup
TrueNAS Immich checks for mobile upload permissions, server storage, and a read-back sample. Start with the guide below, then use the service page if the symptom needs a remote session.
Immich TrueNAS Permission Denied: Diagnose the Upload Denial
Mobile or web uploads fail with permission denied even though the dataset has free space. Diagnose the Immich TrueNAS permission denied error with exact checks and a verification test.
Immich Mobile Upload Stuck on the First Batch: A Technician's Checklist
Phone says backup started but photos stop after the first batch? Work through these checks to find why Immich mobile upload is stuck on TrueNAS.
Immich Container Restarts Repeatedly After a Failed Database Migration
Troubleshoot an Immich container that restarts repeatedly after a failed database migration on TrueNAS, with checks, verification, and recovery steps.
Immich App Container Restart Loop on TrueNAS: Diagnose the Crash Before It Wipes Your Uploads
Stop the Immich container from restarting repeatedly on TrueNAS. Check logs, resources, and storage, then verify recovery without losing your phone photo library.
Immich Mobile Backup Stops After First Batch: Fix Background Upload Stalls
Troubleshoot Immich mobile backup that stops after the first batch on TrueNAS. Check background upload settings, verify with a test batch, and recover safely.
Immich Upload Denied by Dataset Permissions: Diagnose the Storage Path
Troubleshoot Immich uploads denied by dataset permissions on TrueNAS. Check ownership, ACLs, and the storage path, then verify with a test file and recover safely.
Immich Backup Job Failed: Thumbnails Stuck Generating on TrueNAS
Troubleshoot an Immich backup job failed state on TrueNAS where new assets upload but thumbnail generation never finishes, with checks, a verification test, and recovery steps.
Immich External Library Not Scanning: Diagnose a Mounted Folder With No Assets
A mounted photo folder in Immich shows no assets on TrueNAS. Follow these checks to diagnose why the external library is not scanning and restore it.
Immich Server Not Reachable from Phone: Fix the Mobile App When Web UI Works
Your phone can't reach Immich even though the web UI works on LAN? Follow these checks to diagnose and fix the immich server not reachable phone issue on TrueNAS.
Immich Upload Stuck: Why Mobile Backup Halts After the First Batch
Troubleshoot Immich mobile backup that stops after the first batch on TrueNAS. Check server logs, permissions, and network to restore full photo uploads.
Immich Mobile Backup Stops After the First Batch on TrueNAS
Troubleshoot Immich mobile backup stalling after the first batch on TrueNAS. Check server reachability, permissions, and storage, then verify with a test upload.
Immich Upload Denied by Dataset Permissions: A Controlled Diagnosis on TrueNAS
Mobile or web uploads fail while the Immich dataset has free space. Diagnose immich truenas permission denied with exact checks, a verification test, and rollback steps.
Immich Mobile Backup Stalls After the First Batch: Diagnose the Queue
Fix Immich mobile backup that stops after the first batch on TrueNAS by checking the upload queue, server logs, and app state, then verifying with a controlled test.
Immich Database Migration Failed: Stop the Restart Loop on TrueNAS
Immich container restarting repeatedly after a database migration failure on TrueNAS? Follow these checks to read the logs, verify the database, and recover safely.
Immich App Container Restart Loop on TrueNAS: Diagnose and Recover
Immich container restarts repeatedly and the web UI is unavailable. Follow these checks to diagnose the loop and restore a stable Immich app container restart.
Immich Backup Job Failed: Thumbnail Generation Stuck on TrueNAS
Diagnose an immich backup job failed state where new phone photos appear but thumbnails never finish generating on TrueNAS, with checks, a verification test, and recovery steps.
Immich External Library Not Scanning: Fix a Mounted Folder With No Assets
Troubleshoot an Immich external library that shows no assets after adding a mounted photo folder on TrueNAS, with permission checks and a verification test.
Immich Mobile Backup Stalls After the First Batch: Fix Background Upload
Troubleshoot Immich mobile backup that stops after the first batch on TrueNAS. Check background upload settings, battery optimization, and verify with a test batch.
Immich Storage Path Permission: Diagnosing Upload Denied by Dataset Permissions
Mobile or web Immich uploads fail with permission denied even though the TrueNAS dataset has free space. Here is a focused check of the immich storage path permission and a verification test.
Immich Thumbnail Generation Stuck on TrueNAS: Diagnose and Recover
New photos appear in Immich on TrueNAS, but thumbnails never finish generating. Follow these checks to diagnose the stuck job and restore thumbnail generation.
Fix Immich Upload Denied by Dataset Permissions on TrueNAS
Troubleshoot Immich uploads failing with permission denied on TrueNAS. Check dataset ownership, ACLs, and verify with a test file.
Immich Mobile Backup Stops After First Batch: Diagnose the Stall
Troubleshoot Immich mobile backup stopping after the first batch on TrueNAS. Check upload logs, app permissions, and server storage, then verify with a test album.
Immich Mobile Upload Stuck After the First Batch on TrueNAS
Troubleshoot Immich mobile backup that stops after the first batch on TrueNAS. Check server logs, app permissions, and network to restore uploads.
Immich Server Not Reachable from Phone: Fix LAN Access When Web UI Works
Phone can't reach Immich on TrueNAS even though the web UI works on LAN? Diagnose the immich server not reachable phone issue with exact checks and a verification test.
Immich Upload Stuck at the First Batch: A Step-by-Step Fix
Phone backup starts but photos stop after the first batch on your TrueNAS Immich server. Follow these checks to confirm the cause and restore a full mobile backup.
Immich Phone Photos Not Backing Up: Client, Permission, Server
A three-layer Immich backup test covering mobile permissions, server storage, and a read-back sample.