Troubleshooting guide
Immich Thumbnail Generation Stuck on TrueNAS: Diagnose and Recover
Category: Photo Backup
You added new photos to Immich on your TrueNAS host, the assets show up, but the thumbnail generation stays stuck and the grid stays blank.
Check the Job Queue
Open Immich’s administration panel and look at the job queue for thumbnails. If the queue shows a growing number of pending jobs with no active worker, the worker is not processing. If it shows one job running for an unusually long time, a single asset may be blocking the queue. Note the count before changing anything so you can compare later.
Inspect the Logs
On TrueNAS, open the Immich app logs and filter for thumbnail or job worker entries. Look for repeated errors such as permission denied, out of memory, or a missing file path. A permission error on the upload or thumbnail folder is the most common cause: the container user cannot read the original asset. Confirm the dataset permissions allow the Immich user to read and write.
Verify Storage and Resources
Check that the dataset holding Immich data has free space. A full pool stops thumbnail writes silently. Also confirm the container has enough memory; thumbnail workers can be killed when memory is tight, leaving jobs pending.
Verification Test
Restart the Immich app from TrueNAS, then upload one new photo from your phone. Watch the thumbnail queue: the job should move from pending to active and finish within a minute. If the new thumbnail appears, generation is working again.
Rollback and Recovery
If the restart does not clear the backlog, pause the thumbnail job, clear the failed jobs, and resume it. Before changing permissions or configuration, snapshot the Immich dataset so you can roll back if the app fails to start. If the immich thumbnail generation stuck state returns after these steps, the logs will show whether the cause is storage, permissions, or memory. For a guided review,
