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