Unable to run job handler (PersonGenerateThumbnail): Error: Input file is missing
Hi all!
Since last week, I started noticing some errors regarding missing input files. It seems to mainly affect jobs such as the thumbnail generator, as well as when trying to download an image.
I’m currently running v2.2.0, but I suspect this issue has been present for a while and does not apply to all assets.
Observed behavior:
When certain jobs run, I see log messages like this:
However, when checking the file on disk, the extension is lowercase (.heic) instead of uppercase (.HEIC) as referenced in the logs.
What I’ve checked:
- Verified that the file exists on the filesystem (with lowercase extension).
- Checked the public.assets table in the database — confirmed that the originalPath references the file with capitalized extension.
- Noticed that this behavior is inconsistent — some assets use lowercase extensions, while others use uppercase.
- All affected assets belong to a single user who uploads exclusively via the iOS mobile app.
Potential solutions (looking for guidance):
- Rename files on the filesystem to match the paths stored in the database.
- Update the originalPath values in the database to match what’s actually on disk.
Before applying either fix, I wanted to confirm which approach would be safer, or if there’s a recommended alternative to handle this properly.
Environment:
- Immich version: v2.2.0
- Upload source: iOS mobile app
- Running in Docker
Please let me know if you need any other information!
Since last week, I started noticing some errors regarding missing input files. It seems to mainly affect jobs such as the thumbnail generator, as well as when trying to download an image.
I’m currently running v2.2.0, but I suspect this issue has been present for a while and does not apply to all assets.
Observed behavior:
When certain jobs run, I see log messages like this:
[Nest] 19 - 11/05/2025, 2:34:40 PM ERROR [Microservices:{"id":"a67f978d-8e4a-4d89-9ead-2e7f23788f47"}] Unable to run job handler (PersonGenerateThumbnail): Error: Input file is missing: /photos/library/tessa/2024/2024-09/IMG_1889.HEICHowever, when checking the file on disk, the extension is lowercase (.heic) instead of uppercase (.HEIC) as referenced in the logs.
What I’ve checked:
- Verified that the file exists on the filesystem (with lowercase extension).
- Checked the public.assets table in the database — confirmed that the originalPath references the file with capitalized extension.
- Noticed that this behavior is inconsistent — some assets use lowercase extensions, while others use uppercase.
- All affected assets belong to a single user who uploads exclusively via the iOS mobile app.
Potential solutions (looking for guidance):
- Rename files on the filesystem to match the paths stored in the database.
- Update the originalPath values in the database to match what’s actually on disk.
Before applying either fix, I wanted to confirm which approach would be safer, or if there’s a recommended alternative to handle this properly.
Environment:
- Immich version: v2.2.0
- Upload source: iOS mobile app
- Running in Docker
Please let me know if you need any other information!
