Help solving an issue
Hello!
I'm a fairly new user of Immich and Linux in general. I've been self-teaching a lot while building my homelab setup, but I’ve run into an issue that I don’t fully understand and haven’t been able to resolve.
The error occurs during the thumbnail generation task. It starts with:
[Nest] 7 - 09/17/2025, 6:00:45 PM ERROR [Microservices:{"id":"20a1c665-b2a9-4f09-9a35-54ad79de4a99"}] Unable to run job handler (AssetGenerateThumbnails): Error: VipsOperation: class "icc_transform" not found
VipsOperation: class "icc_transform" not found
VipsJpeg: premature end of JPEG image
Error: VipsOperation: class "icc_transform" not found
I did my best to configure my integrated GPU (Intel HD Graphics 630), but I suspect this might be related to the issue…
I’ve attached the log, my docker-compose.yml, and the .env file to this post. For reference, I use Portainer to manage my containers.
Thanks a lot for your help — and have a great day! 😊
4 Replies
:wave: Hey @OhtNa_,
Thanks for reaching out to us. Please carefully read this message and follow the recommended actions. This will help us be more effective in our support effort and leave more time for building Immich :immich:.
References
- Container Logs:
docker compose logs docs
- Container Status: docker ps -a docs
- Reverse Proxy: https://immich.app/docs/administration/reverse-proxy
- Code Formatting https://support.discord.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline#h_01GY0DAKGXDEHE263BCAYEGFJA
Checklist
I have...
1. :ballot_box_with_check: verified I'm on the latest release(note that mobile app releases may take some time).
2. :ballot_box_with_check: read applicable release notes.
3. :ballot_box_with_check: reviewed the FAQs for known issues.
4. :ballot_box_with_check: reviewed Github for known issues.
5. :ballot_box_with_check: tried accessing Immich via local ip (without a custom reverse proxy).
6. :ballot_box_with_check: uploaded the relevant information (see below).
7. :ballot_box_with_check: tried an incognito window, disabled extensions, cleared mobile app cache, logged out and back in, different browsers, etc. as applicable
(an item can be marked as "complete" by reacting with the appropriate number)
Information
In order to be able to effectively help you, we need you to provide clear information to show what the problem is. The exact details needed vary per case, but here is a list of things to consider:
- Your docker-compose.yml and .env files.
- Logs from all the containers and their status (see above).
- All the troubleshooting steps you've tried so far.
- Any recent changes you've made to Immich or your system.
- Details about your system (both software/OS and hardware).
- Details about your storage (filesystems, type of disks, output of commands like fdisk -l and df -h).
- The version of the Immich server, mobile app, and other relevant pieces.
- Any other information that you think might be relevant.
Please paste files and logs with proper code formatting, and especially avoid blurry screenshots.
Without the right information we can't work out what the problem is. Help us help you ;)
If this ticket can be closed you can use the /close command, and re-open it later if needed.
Successfully submitted, a tag has been added to inform contributors. :white_check_mark:This means one of your pictures is (slightly) malformed and unable to generate a thumbnail
This thread has been closed. To re-open, use the button below.
Thanks !!! 😄