October 30, 2025
— Immich Team
Release notes for v2.2.0 — v2 stable docker tag, OCR, an even faster justified layout implementation on web, various features that are now on mobile, and more!!
The month following our _stable release _🎉 has flown by! We are blown away by the support from everyone around this milestone, especially for the _Retro DVD _*📀**! If you want to get one for yourself, you still can, but once this batch is gone, we won't be making any more, EVER! So get one while you can from* *immich.store**!*
Welcome to version v2.2.0 of Immich. This release comes with the traditional Immich fashion, where the features and enhancements list is longer than the bug fixes list. Let's dive right into the highlights of this exciting release
v2 versionsv2 versionsThe example.env file has been updated to use IMMICH_RELEASE=v2, which is a mutable Docker tag that points to the latest 2.x.x release image.
OCR search has been one of the most requested features on our users' wishlists. Thanks to the fantastic work of @flipped-1121 and @mertalev, Immich can now recognize texts in images, adding a powerful capability to its already powerful search features. This will help users find lost family recipes or a crypto wallet's passphrase more easily.
The OCR pipeline is integrated into the existing machine learning flow. For new uploads, it will run automatically with the existing machine learning flow. For existing setups, you can go to Administration > Job > Click on "All" for OCR job to extract OCR information for your gallery
To search for letters in photos, a new radio button has been added to the search type on the web app, and in the dropdown list on the mobile app.
This release comes with a blazing-fast re-implementation of the justified layout on the web, which makes calculating the size of the thumbnails in each bucket several times faster, significantly improving the rendering performance for a large bucket, i.e., 10s of thousands of assets in a single month
To help you decide which asset to keep in a group of duplicates, more information has been added to the info section below each asset, including date/time, location, and the number of albums the asset is in. The info section has been redesigned to make scanning the information faster, with different properties getting highlighted. We will keep improving on this interface to make it more intuitive
You can view and navigate to the albums that the asset belongs to in the info sheet
The popular feature "Show similar photos" has made its way to the mobile app. You can use the button in the detail sheet to find similar images to the one you are viewing.
The album's activity view now displays the messages and actions in a chat-style view, making it easier to follow
The progress bar of the video player now has higher precision duration handling. This makes seeking much more fluid than before, as well as making position updates in the progress bar smooth, rather than jumping from second to second.
As we are now in the stable-era, we want to make the notification of a new version more subtle, less distracting. The update message and icon's color on the mobile app have been redesigned for that purpose.
When your server version is older than the available one, a message with a clickable link is displayed, directing you to the latest release notes.
When your mobile app version is older than the one available on the App Store, a message with a clickable link appears, directing you to the App Store to perform the update.
Full Changelog: https://github.com/immich-app/immich/compare/v2.1.0...v2.2.0
Cheers,
The Immich Team