ImageGenius Changes:
rebase to alpine edge
immich Changes:
v1.106.4
Hotfixes
This release addresses the following bugs:
- fix(server): use preview image when generating person thumbnail from video by @mertalev in immich-app/immich#10240
- fix(server): load original image for gifs by @michelheusschen in immich-app/immich#10252
Include the previous release note below for your convenience.
Highlights
BREAKING CHANGES
Warning
1. Underlying API changes
Please ensure your mobile app and server are on the same version. Otherwise, you won't be able to access the app.
We advise you to wait for the mobile app to be reviewed and released from the app stores before updating your instance to avoid disrupting your users.
2. Environment variables
SERVER_PORT
,MICROSERVICES_PORT
, andMACHINE_LEARNING_PORT
were renamed toIMMICH_PORT
HOST
andMACHINE_LEARNING_HOST
were renamed toIMMICH_HOST
3. Removal of the immich-microservices
container
The microservices container/process can now be deployed within the immich-server container itself and is done so by default.
Please refer to our documentation for a detailed explanation of this change and a way to keep microservices as a separate container.
Please edit your docker-compose.yml
file with the following changes. If you use hardware acceleration previously in immich-microservices
, you can move the extends
block's content to the immich-server
service to keep the same functionality.
When you bring the container up, please make sure to include the --remove-orphans
flag, so that the immich-microservices
container is removed properly. So the full command will be docker compose up -d --remove-orphans
services:
immich-server:
container_name: immich_server
image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
- command: ['start.sh', 'immich']
volumes:
- ${UPLOAD_LOCATION}:/usr/src/app/upload
- /etc/localtime:/etc/localtime:ro
env_file:
- .env
ports:
- 2283:3001
depends_on:
- redis
- database
restart: always
- immich-microservices:
- container_name: immich_microservices
- image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
- # extends: # uncomment this section for hardware acceleration - see https://immich.app/docs/features/hardware-transcoding
- # file: hwaccel.transcoding.yml
- # service: cpu # set to one of [nvenc, quicksync, rkmpp, vaapi, vaapi-wsl] for accelerated transcoding
- command: ['start.sh', 'microservices']
- volumes:
- - ${UPLOAD_LOCATION}:/usr/src/app/upload
- - /etc/localtime:/etc/localtime:ro
- env_file:
- - .env
- depends_on:
- - redis
- - database
- restart: always
Highlights
Welcome to release v1.106.0
of Immich. Woooh, this release is packed with many new features, improvements, and bug fixes. This is one of the longest release stretches we have ever done, with over 230 closed PRs over a month. I hope you enjoy this release as much as we do, and we have more brewing on the horizon; let's go over some of the highlights of the release below:
- Removal of the
immich-microservices
container - Similar image detection and management
- End-to-end acceleration for NVENC and QSV transcoding
- Better video thumbnails
- Email notifications for album events
- Per user email notifications settings
- Send a test email when configuring the SMTP email server
- Public roadmap (here)
- Translation on the web
- Notable fix: Fixed an edge case bug on mobile synchronization when there is a bad file with date time information. Thanks @fyfrey so much!
Removal of the immich-microservices
container
"microservices be gone" - Zack
Actually, it is still there but in a true microservices manner where we spawn it in a separate process. Woohoo, one more container down to simplify the official setup of Immich!
This change is one of many pieces of upcoming work to change how we handle jobs. Microservices were always a patch for the problem that we couldn't run background tasks within the main server, which would introduce contention for the API itself. Using workers, we can now have these within the same container, separated into different V8 engines. Moving forward, we will be looking to split out "microservices" into actual microservices such as transcoding, thumbnails, etc., allowing such things as distributing transcoding alone to another instance.
Architecture
The immich-server
container contains multiple workers:
api
: responds to API requests for data and files for the web and mobile app.microservices
: handles most other work, such as thumbnail generation and video encoding, in the form of jobs. Simply put, a job is a request to process data in the background.
Split workers [Optional]
If you prefer to throttle or distribute the workers, you can use the environment variables to specify which container should pick up which tasks.
For example, for a simple setup with one container for the Web/API and one for all other microservices, you can do the following:
Copy the entire immich-server
block as a new service and make the following changes to the copy:
- immich-server:
- container_name: immich_server
...
- ports:
- - 2283:3001
+ immich-microservices:
+ container_name: immich_microservices
Once you have two copies of the immich-server service, make the following changes to each one. This will allow one container only to serve the web UI and API and the other one to handle all other tasks.
services:
immich-server:
...
+ environment:
+ IMMICH_WORKERS_INCLUDE: 'api'
immich-microservices:
...
+ environment:
+ IMMICH_WORKERS_EXCLUDE: 'api'
Similar image detection
This release adds the much-anticipated ability to detect duplicate assets that aren't exactly identical, whether because of a difference in resolution, compression or metadata. To give you control over which asset(s) to keep, the assets aren't deduplicated immediately. Instead, there's a new Duplicates page where you can review duplicates to keep or trash them. An asset with the largest file size is selected by default.
Deduplication-action.mp4
To get started, you can run the new duplicate detection job on all assets. You won't need to do this for new assets, as they'll be automatically processed.
The Duplicates page is under a new Utilities section in the sidebar. Stay tuned for other features that will go into this section!
End-to-end hardware-accelerated transcoding
Until now, hardware acceleration for most backends only applied to encoding; decoding and tone-mapping were still done on the CPU. There's now an opt-in hardware decoding toggle that allows you to accelerate the full transcoding process for NVENC, QSV, and RKMPP. Some testing showed a 10x speed improvement compared to accelerated encoding alone (results are subject to your hardware and the video itself, of course).
Keep in mind that hardware and video compatibility becomes more relevant with this setting, which is why it's currently opt-in.
Special thanks to Jellyfin's @nyanmisaka for their helpful tips and suggestions for this feature!
Better video thumbnails
Immich now tries to find a descriptive video thumbnail instead of simply using the first frame. No more black images for thumbnails!
Before:
After:
This change won't apply retroactively to existing videos. To update video thumbnails, you can either select them and choose Refresh Thumbnails from the overflow menu or re-run thumbnail generation on all assets through the job panel to update all of them.
Additional email notifications
Two new event types have been added for which email notifications can be sent out:
- You are added to a shared album.
- New media is added to an album.
Also, users can now control their notification settings for each event. Notification preferences can be viewed on the web account settings page.
Translation on the web
We have added translation for Immich on the web. You can help us translate the web to your native language by accessing our Weblate project here.
You can change the app to your language from the Account Settings > App Settings > Language
What's Changed
🗄️ Server
- fix(server): use preview image when generating person thumbnail from video by @mertalev in immich-app/immich#10240
- fix: load original image for gifs by @michelheusschen in immich-app/immich#10252
- chore(server): optional originalMimeType in asset response payload by @alextran1502 in immich-app/immich#10272
📱 Mobile
- chore(mobile): post release task by @alextran1502 in immich-app/immich#10228
🖥️ Web
- feat(web): Language settings list UX nits by @bo0tzz in immich-app/immich#10261
- fix(web): more language selector nits by @zackpollard in immich-app/immich#10271
- chore(web): remove unnecessary input.select for lang selector by @zackpollard in immich-app/immich#10273
- chore(web): translations in page load functions by @michelheusschen in immich-app/immich#10260
- chore(web): update translations by @weblate in immich-app/immich#10224
- feat(web): add chinese (traditional), bislama and croatian to our supported languages by @zackpollard in immich-app/immich#10283
📓 Documentation
- chore(docs): Delete unsupported SQL shenanigans by @bo0tzz in immich-app/immich#10278
- chore(doc): update quick-start.mdx by @richard-salam in immich-app/immich#10276
Other changes
- chore: additional makefile targets by @midzelis in immich-app/immich#10243
New Contributors
- @richard-salam made their first contribution in immich-app/immich#10276
Full Changelog: immich-app/immich@v1.106.3...v1.106.4