Immich Error Loading Image: Trace the Cause Safely
A source-backed path for missing originals, failed thumbnails, storage mounts, and version-specific Immich image errors.
Direct answer
“Error loading image” is a symptom, not one confirmed cause. Start with the System Integrity report and server logs. Check whether the original exists at the path Immich stores, then check whether the thumbnail job completed. Do not delete library files from the host.
Quick diagnosis
- Open the maintenance page and review missing files, untracked files, and checksum mismatches.
- Confirm the original and thumbnail paths are mounted inside the container.
- Check the Jobs page for thumbnail generation failures.
- Record the server version before comparing a GitHub report.
What real reports show
Issue #26720 (v2.5.6, Debian 13.3/Raspberry) found database assets whose underlying upload files were missing. A later maintainer comment says write synchronization changes were merged, but that does not repair already missing files.
Issue #23574 (v2.2.1, Ubuntu/Docker) includes ENOENT errors for thumbnail paths. Discussion #10570 (v1.106.4) reports improvement after refreshing thumbnails, but it is unanswered and historical.
Safe next step
Use the integrity report and logs to classify the failure before changing storage. If the file is missing, restore the original from backup or treat the asset as a data-recovery case. If only generated thumbnails are missing, use the documented job controls and watch the logs.