v3.3.0-rc.2

[!WARNING]

Disclaimer

This is a release candidate, not a stable release. It is subject to change and may contain bugs or breaking changes. As always, make sure you have a backup of your database and library before upgrading to this version.

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

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 https://github.com/immich-app/immich/pull/32015

🐛 Bug fixes

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

Full Changelog: https://github.com/immich-app/immich/compare/v3.3.0-rc.1…v3.3.0-rc.2