v3.4.0-rc.2

Welcome to the second release candidate of v3.4; v3.4.0-rc.2! This release exclusively contains bug fixes. Keep reading below for the draft release notes and instructions on how to run this release candidate.

Release notes

Work-in-progress release notes can be found here:

https://pr-934.dev.immich.app/blog/v3.4.0-release

Machine Learning

Set MACHINE_LEARNING_MODEL_REVISION=v2 to take full advantage of the memory usage and performance improvements in this release.

Server

To use this RC version on the server, update the IMMICH_VERSION in your .env file:

IMMICH_VERSION=v3.4.0-rc.2

or

IMMICH_VERSION=v3-rc

Then pull and restart:

docker compose pull && docker compose up -d

Mobile

To use this RC version on the mobile app, follow the appropriate link for your platform:

Android

You can download the APK in the release note below, or tap on "Join the beta" from the Google Play Immich page

iOS

The iOS app is available via Testflight: https://testflight.apple.com/join/JTSTucBd

If you run into any issues, please report them on GitHub so we can address them before the final release. Thank you for helping us test!

And as always, bugs are fixed, and many other improvements also come with this release.

What's Changed

🐛 Bug fixes

• fix(mobile): show 10-bit heic and avif originals on ios by @santoshakil in #32821
• fix(server): keep ocr search text after edits and thumbnail regeneration by @Shadi-Alrashoodi in #32577
• fix: font loading by @danieldietzler in #32873
• fix: remove asset from album doesn't resize the timeline by @alextran1502 in #32856
• fix: web worker import by @danieldietzler in #32876
• fix: oauth regressions by @danieldietzler in #32934
• fix: web error handler by @danieldietzler in #32935
• fix: people page websockets by @danieldietzler in #32940
• fix(ml): disable onnxruntime telemetry by @mjkent in #32956
• fix(server): read only valid ISO values by @Snowknight26 in #32938
• fix(server): validate motion photo video range before extraction by @bo0tzz in #32931
• fix(web): scroll memory by @danieldietzler in #32964
• fix(mobile): log out before resetting the local database by @santoshakil in #32928
• fix: asset viewer reactivity by @danieldietzler in #32978

New Contributors

• @Shadi-Alrashoodi made their first contribution in #32577
• @mjkent made their first contribution in #32956
• @medienbaecker made their first contribution in #32946

Full Changelog: v3.4.0-rc.1...v3.4.0-rc.2

Unfortunately we missed that onnxruntime enabled telemetry by default in a recent release, resulting in the ML container automatically sending anonymous metric data to Microsoft. We have now disabled it. Apologies to everyone that we did not catch this change immediately, and thanks to our community for flagging it!

What's Changed

🐛 Bug fixes

• fix(ml): disable onnxruntime telemetry by @mjkent in #32956

New Contributors

• @mjkent made their first contribution in #32956

Full Changelog: v3.3.5...v3.3.6

v3.4.0-rc.1

Welcome to the first release candidate of v3.4; v3.4.0-rc.1 (yeah yeah, we had to sacrifice a release again)! Keep reading below for the draft release notes and instructions on how to run this release candidate.

Release notes

Work-in-progress release notes can be found here:

https://pr-934.dev.immich.app/blog/v3.4.0-release

Server

To use this RC version on the server, update the IMMICH_VERSION in your .env file:

IMMICH_VERSION=v3.4.0-rc.1

or

IMMICH_VERSION=v3-rc

Then pull and restart:

docker compose pull && docker compose up -d

Mobile

To use this RC version on the mobile app, follow the appropriate link for your platform:

Android

You can download the APK in the release note below, or tap on "Join the beta" from the Google Play Immich page

iOS

The iOS app is available via Testflight: https://testflight.apple.com/join/JTSTucBd

If you run into any issues, please report them on GitHub so we can address them before the final release. Thank you for helping us test!

And as always, bugs are fixed, and many other improvements also come with this release.

What's Changed

🔒 Security

• fix(server): apply shared link metadata visibility in asset mapper by @bo0tzz in #32561
• fix(server): anchor plugin allowedHosts matching by @bo0tzz in #32560
• fix(server): require upload access for checksum duplicate check by @bo0tzz in #32559
• fix(server): escape template variables in custom email templates by @bo0tzz in #32563
• fix(cli): only act on files that were sent in the bulk upload check by @bo0tzz in #32564
• fix(server): restrict partner timeline requests to timeline assets by @bo0tzz in #32565
• fix(server): sanitize EXIF template variables and tighten storage path check by @bo0tzz in #32566
• fix(server): only serve edited assets to shared links in archive downloads by @bo0tzz in #32562
• fix(server): only set OAuth cookies for server-generated state by @bo0tzz in #32600
• fix(server): do not expose album members to shared link viewers by @bo0tzz in #32607
• fix(server): dont follow symlinks by @etnoy in #32614
• fix(server): exclude partners' locked assets from legacy search by @bo0tzz in #32604
• feat(server): remove deprecated password field from update-me by @bo0tzz in #32623
• fix(server): require update access on the motion video when linking a live photo by @bo0tzz in #32606
• feat: inline hashes in helmet CSP by @bo0tzz in #30529
• fix(server): scope duplicate group resolution to the caller's assets by @bo0tzz in #32603

🚀 Features

• feat: option for mobile smooth timeline scrubbing by @TiDeane in #32552
• feat: passkeys by @jrasm91 in #32194
• feat(mobile): jxl decoder by @mertalev in #32592
• feat(server): add jxl as target format by @mertalev in #32732
• feat: backups by @insertish in #32268

🌟 Enhancements

• feat(mobile): mobile tags by @staticdog in #30753
• feat(mobile): limit max zoom by image pixel size by @LeLunZ in #32423
• feat(mobile): share logs from the startup error screen by @santoshakil in #32288
• perf(web): reduce favicon assets by @cevdetch in #32594
• perf: RKNN half RAM model usage + no weight duplication in multi-core by @todorangrg in #23958
• feat: workflow filter by missing EXIF property by @austinmdillow in #32713
• feat(server): add OCR extraction workflow filter by @avaly in #32464
• fix: avoid duplicate manufacturer in camera name by @brent20 in #32657
• feat(web): enable the shortcut "f" to favorite/unfavorite in multiselection mode by @Bautrell12 in #31411
• feat(server): compress database backups with pigz when it is installed by @zackpollard in #32806
• feat: futo backups 1.12.1 with restic's parallel scan by @zackpollard in #32830

🐛 Bug fixes

• fix(mobile): stop playing video when dismissing on iOS by @agg23 in #31772
• fix(mobile): sort timeline assets by the date their headers group on by @santoshakil in #30262
• fix(mobile): cancel the iOS background uploads when the foreground backup starts by @santoshakil in #31944
• fix(server): offline live photo motion deletion by @zackpollard in #32077
• fix(mobile): decouple delete action messages from context by @PeterOmbodi in #31093
• fix(mobile): start the session when a link opens the app by @santoshakil in #32181
• fix(mobile): prevent timeline bucket selection provider leak by @PeterOmbodi in #32100
• fix(mobile): format year filter chip without thousands separator by @devyourown in #32159
• fix(ml): move logging config to code by @bo0tzz in #32220
• fix(mobile): stop long images squishing on android by @santoshakil in #32213
• fix(logging): avoid multiline logging of feature flags in server service by @brandon1024 in #32275
• fix(ml): Round OCR max resolution up to a multiple of 32 by @murarustefaan in #32263
• fix(web): don't swallow Escape in sidebar by @ChocolateChipKookie in #32364
• fix(web): event manager forgetting subscribed callbacks by @meesfrensel in #32217
• fix(web): update album start date when the album changes by @DawidKrynski in #32242
• perf(server): check shared link asset access without scanning the album by @bo0tzz in #32411
• perf(server): stop loading every album asset to build album responses by @bo0tzz in #32413
• perf(server): stop aggregating every album asset when loading a shared link by @bo0tzz in #32412
• fix(mobile): show play instead of replay button for unplayed videos by @LeLunZ in #32307
• fix(mobile): render random widget images at the widget's display resolution by @devyourown in #32215
• fix(mobile): save typed coordinates in the location picker by @santoshakil in #32460
• fix(mobile): sort time zones by name within the same offset by @devyourown in #32087
• fix(mobile): Keep asset viewer controls hidden if they were hidden before zooming. by @dagstuan in #31832
• fix: user admin actions by @jrasm91 in #32491
• fix: smtp email visibility by @jrasm91 in #32492
• fix(web): update FaceEditor to handle HLS video elements correctly by @T-Zaid in #32538
• fix: unsupported locale for date format by @shenlong-tanwen in #32267
• fix(mobile): fallback localizations for unsupported locales by @santoshakil in #32452
• fix(mobile): hide server addresses and tokens in shared logs by @santoshakil in #32287
• fix: locking around concurrency-1 jobs by @bo0tzz in #28410
• fix(mobile): hide server addresses in upload error logs by @santoshakil in #32550
• perf(server): index updateId on asset_face, stack and workflow by @bo0tzz in #32432
• fix(ml): preloaded model loaded twice by @YarosMallorca in #32610
• fix(mobile): keep header image when starting selection by @clementdelestre in https://github.c...

https://xkcd.com/221/

What's Changed

🔒 Security

• chore(deps): update python docker digests by @bo0tzz in #32635
• chore(deps): update dependency certifi to v2026.10.19 by @bo0tzz in #32636

Full Changelog: v3.3.4...v3.3.5

Turns out the last people performance fix wasn't quite there for some people. We have now finally resolved that issue.

What's Changed

🐛 Bug fixes

• fix: missing translation by @waclaw66 in #32485
• perf(server): more efficient person queries by @mertalev in #32523

Full Changelog: v3.3.3...v3.3.4

Well, you know how it goes... Misclick once and a release is sacrificed 😅 The second patch release v3.3.3 has some more bug fixes, notably a major performance improvement for the explore page.

What's Changed

🐛 Bug fixes

• fix(mobile): show the memories date in every app language by @santoshakil in #32259
• perf(server): improve people query performance by @zackpollard in #32405

Full Changelog: v3.3.1...v3.3.3

This patch addresses various bugs around people sharing, as well as a scroll issue on mobile. Further, there is now an indicator showing which people are shared.

What's Changed

🌟 Enhancements

• feat: shared person indicator by @danieldietzler in #32223

🐛 Bug fixes

• fix(mobile): keep memories full screen while swiping by @santoshakil in #32171
• fix(server): read ISO values above 65535 by @bo0tzz in #32182
• fix: include partner shared assets for people even without showInTimeline by @danieldietzler in #32219
• fix: clarify people sharing does not share assets by @jrasm91 in #32231
• fix(mobile): prevent rapid toggling and rerendering of cells by @agg23 in #32200
• fix: include unamed people in otherPeople by @jrasm91 in #32237
• fix: run workflow steps in their configured order by @infocus13 in #32240
• fix: show date on memories page by @alextran1502 in #32206

📚 Documentation

• docs: document persistent QNAP database storage by @yuhuan417 in #32222
• docs: Add MACHINE_LEARNING_MODEL_REVISION variable to docs by @JPar99 in #32221

🌐 Translations

• chore(web): update translations by @weblate in #32029

New Contributors

• @yuhuan417 made their first contribution in #32222
• @JPar99 made their first contribution in #32221
• @infocus13 made their first contribution in #32240

Full Changelog: v3.3.0...v3.3.1

v3.3.0

Welcome to Immich v3.3.0!

This release includes people sharing, birthday memories, auto-stacked mobile edits, and a variety of other enhancements and bug fixes. Keep reading below for the full list of highlights.

Highlights

• Shared people management
• Birthday memories
• Auto-stacked mobile edits
• Sync OAuth claims on every login
• Higher quality thumbnails and previews
• Machine learning performance and accuracy improvements (opt-in)
• New OCR models
• Notable fix: correct storage size on MacOS

Shared people management

We are very pleased to release the next big milestone towards better sharing: people can now be shared!

As a user you can share people with another user in your cluster group:

When sharing a person with another user, the shared person:

• Shows up in both users’ list of people (on mobile and web)
• Shows up in the asset viewer / asset detail view on both owned and shared assets
• Can be edited by both users (only the name & birth date fields)

By default, changes to the name & date of birth are reflected for both users. On the web, the “Edit person” modal has an option to change the name/date of birth for “Only me” instead of the whole group.

Also, there is a preference for this behavior in the “Sharing settings”, which can be changed to make this the default behavior when editing a person. The setting can be changed here: https://my.immich.app/user-settings?isOpen=feature+people.

The setting has two options:

• “Everyone with shared access” — means an update will apply for everyone, covering the typical family use case where one or two users are supposed to be responsible for the entire family's people.
• “Only me” — means the names and dates of births will remain unchanged for other users

Lastly, by allowing cross-user merging, you can now merge a face from your own assets with people shared with you from other users. This is especially helpful if you didn't want to re-run facial recognition after joining a cluster group before. Now, after setting up bi-directional sharing, users can manually link people together.

Birthday memories

In an effort of making Immich more joyful to use, we are introducing memories for people's birthdays.

If it's the birthday of a person in your library, Immich will now celebrate that with a special memory featuring previous birthdays.

Auto-stacked mobile edits

When using something other than Immich for editing images on your phone, Immich will now stack those edits on top of the original. This allows for Immich to show all edits in one place, without cluttering the timeline.

This should provide a more organized timeline, especially when you heavily rely on editing assets on your phone.

Sync OAuth claims on every login

Immich supports OAuth claims for storage quota, the user role, and the preferred username. Up until now, those were only synced on registration.

Now, they can be synced on every login, allowing you to do active user management through your IDP, updating quotas and roles as you go and as necessary, and Immich will adopt those changes.

Higher quality thumbnails and previews

Immich now uses a more accurate image resampling method, improving detail preservation and brightness, especially for high contrast details. All image formats benefit from this change.

Before

After

Thumbnails already generated before this release won’t be affected by this change. To make it apply to existing thumbnails, you can run thumbnail generation on all assets in the job panel.

Machine learning performance and accuracy improvements (opt-in)

After a long list of optimizations, ML is both significantly faster and uses less memory. This affects every backend, including CPU inference. However, the level of improvement varies by model and backend. Cases where certain backends (such as OpenVINO) produced wrong outputs at times should be resolved.

RKNPU, used by Rockchip boards, now supports every model in the catalog including OCR for the first time, bringing it to parity with other backends. Additionally, TensorRT RTX is now used for Ampere (30xx) and newer NVIDIA GPUs, improving performance significantly.

To fully benefit, set MACHINE_LEARNING_MODEL_REVISION=v2to allow more optimized models to be downloaded and used. Many of the improvements rely on these optimized models and will not take effect when using the old ones. The outputs of the new and old models are numerically equivalent, so switching doesn’t require re-running any tasks. This setting will be the default in a later release.

As always, keep in mind that the very first time you load a model requires more preparation work, so don’t be surprised if it takes some time at first. This preparation is cached and reused, so loading the model will be much faster after the first time.

New OCR models

The PP-OCRv6 family is now supported. These models are significantly more accurate than the previous PP-OCRv5 generation while all being multilingual. PP-OCRv6_tiny is efficient and suitable for modest hardware, PP-OCRv6_small is a notable jump in accuracy compared to PP-OCRv5_mobile, and PP-OCRv6_medium improves on PP-OCRv5_server as the highest quality and most demanding option.

Notable fix: correct storage size on MacOS

The block size used to calculate the storage capacity and usage has some nuances to it. In some situations (*cough* Docker on MacOS *cough*), we didn’t have enough information to correctly compute accurate values. With this release, the reported storage usage and capacity should now be correct.

Technical details

Recent NodeJS releases now expose the frsize property, which is sometimes different from bsize (“block size”). In those cases the calculate storage sizes could often be off by a factor of4096 (or more). In fact, #4318 has been our fourth oldest open issue (including the renovate dashboard), opened just over three years ago. Now, with accurate block sizes our storage calculation should be correct, even in Docker on MacOS.

We are very happy to finally see this issue resolved, even though it only meant a dependency bump and a tiny code change for us.

As always, please consider supporting the project.

🎉 Cheers! 🎉

Support Immich

If you find the project helpful, you can support Immich by purchasing a product key at https://buy.immich.app or our merchandise at https://immich.store

What's Changed

🚀 Features

• feat(mobile): stack edited photos over the original on upload by @santoshakil in #31082
• feat: birthday memories by @alextran1502 in #30831
• feat: people management by @danieldietzler in #31620
• feat(ml): trt-rtx by @mertalev in #31863

🌟 Enhancements

• feat(web): improve non-Latin text rendering on the map by @meesfrensel in #31611
• feat: improved storage template onboarding by @bwees in #31531
• feat(web): default the activity log to show the latest by @nekorevend in #28938
• feat(server): linear-light resampling by @mertalev in #31236
• feat(web): add leave album action by @kojomba in #31768
• feat(ml): improve model loading by @mertalev in #31742
• feat(ml): optimized model inference by @mertalev in <https://github.com/immich-app/immic...

v3.3.0-rc.2

Welcome to the third release candidate of v3.3; v3.3.0-rc.2! Some more features, person sharing improvements, and bug fixes. This will likely be the last RC before the v3.3 release. Keep reading below for the draft release notes and instructions on how to run this release candidate.

Release notes

Work-in-progress release notes can be found here:

https://pr-846.dev.immich.app/blog/v3.3.0-release

Machine Learning

Set MACHINE_LEARNING_MODEL_REVISION=v2 to take full advantage of the memory usage and performance improvements in this release.

Server

To use this RC version on the server, update the IMMICH_VERSION in your .env file:

IMMICH_VERSION=v3.3.0-rc.2

or

IMMICH_VERSION=v3-rc

Then pull and restart:

docker compose pull && docker compose up -d

Mobile

To use this RC version on the mobile app, follow the appropriate link for your platform:

Android

You can download the APK in the release note below, or tap on "Join the beta" from the Google Play Immich page

iOS

The iOS app is available via Testflight: https://testflight.apple.com/join/JTSTucBd

If you run into any issues, please report them on GitHub so we can address them before the final release. Thank you for helping us test!

And as always, bugs are fixed, and many other improvements also come with this release.

What's Changed

🌟 Enhancements

• feat(web): add shortcut to remove assets from an album by @immich-push-o-matic[bot] in #32015

🐛 Bug fixes

• fix(ml): serialize trt-rtx sessions by @immich-push-o-matic[bot] in #31963
• fix(ml): widen empty half-precision arrays by @immich-push-o-matic[bot] in #31962
• fix(server): make library exclusion matching consistently case-insensitive by @immich-push-o-matic[bot] in #31973
• fix: storage usage display on virtiofs and alike by @immich-push-o-matic[bot] in #31983
• fix: stale memory thumbnail by @immich-push-o-matic[bot] in #31977
• fix(server): include album owner for album shared links by @immich-push-o-matic[bot] in #31990
• fix(mobile): face thumbnail stuck blank after renaming a person by @immich-push-o-matic[bot] in #32001
• fix(mobile): make the iOS background batch wait for its remote sync by @immich-push-o-matic[bot] in #32003
• fix(mobile): don't start the foreground backup in iOS background launches by @immich-push-o-matic[bot] in #32002
• fix(mobile): don't re-upload a photo the server already has by @immich-push-o-matic[bot] in #32004
• fix(mobile): image jumps when full-res image loads during pinch or zoom animation by @immich-push-o-matic[bot] in #32011
• fix(ml): upgrade to openvino 2026.4.1 by @immich-push-o-matic[bot] in #32020
• fix(cli): sidecar precedence by @immich-push-o-matic[bot] in #32021
• fix: metadata extraction for media streams with unknown profile by @immich-push-o-matic[bot] in #32023
• fix: assetTagFilter any matching by @immich-push-o-matic[bot] in #32027
• fix: improper filename sanitizing by @immich-push-o-matic[bot] in #32028

Full Changelog: v3.3.0-rc.1...v3.3.0-rc.2

v3.3.0-rc.1

Welcome to the second release candidate of v3.3; v3.3.0-rc.1! There have not only been bug fixes, but also new features and more person sharing improvements. Keep reading below for the draft release notes and instructions on how to run this release candidate.

Release notes

Work-in-progress release notes can be found here:

https://pr-846.dev.immich.app/blog/v3.3.0-release

Machine Learning

Set MACHINE_LEARNING_MODEL_REVISION=v2 to take full advantage of the memory usage and performance improvements in this release.

Server

To use this RC version on the server, update the IMMICH_VERSION in your .env file:

IMMICH_VERSION=v3.3.0-rc.1

or

IMMICH_VERSION=v3-rc

Then pull and restart:

docker compose pull && docker compose up -d

Mobile

To use this RC version on the mobile app, follow the appropriate link for your platform:

Android

You can download the APK in the release note below, or tap on "Join the beta" from the Google Play Immich page

iOS

The iOS app is available via Testflight: https://testflight.apple.com/join/JTSTucBd

If you run into any issues, please report them on GitHub so we can address them before the final release. Thank you for helping us test!

And as always, bugs are fixed, and many other improvements also come with this release.

What's Changed

🌟 Enhancements

• feat(mobile): editors can update album title & description by @immich-push-o-matic[bot] in #31959

🐛 Bug fixes

• fix(web): cull offscreen thumbnails on individual shared links by @immich-push-o-matic[bot] in #31891
• fix: person management ids validation and permissions by @immich-push-o-matic[bot] in #31902
• fix(server): person birthdate timezone bug by @immich-push-o-matic[bot] in #31906
• fix(server): make "limit" paramter use z.coerce by @immich-push-o-matic[bot] in #31934
• fix(server): dont queue unneeded jobs when no xmp file exists by @immich-push-o-matic[bot] in #31936
• fix(server): ignore Samsung Gallery rotation tag for HEIF orientation by @immich-push-o-matic[bot] in #31938
• fix: restore folder view scroll position by @immich-push-o-matic[bot] in #31946

Full Changelog: v3.3.0-rc.0...v3.3.0-rc.1