Skip to content

Releases: immich-app/immich

v2.5.6

10 Feb 18:50

Choose a tag to compare

v2.5.6

This patch release addresses the following issues

  • Fixed an issue where thumbnail generation runs every night when full-size image generation option is enabled.
  • Fixed an issue where iOS is slow to start in some cases.
  • Fixed an issue where Android device cannot delete asset using Free Up Space feature if it has more than a few thousand assets

🐛 Bug fixes

📚 Documentation

🌐 Translations

New Contributors

Full Changelog: v2.5.5...v2.5.6

v2.5.5

06 Feb 15:21

Choose a tag to compare

v2.5.5

v2.5.4 was in the way of getting out, and we got another annoyance bug fixed, so we rolled it into v2.5.5

Happy Friday! This release addresses more bugs from the v2.5.0 release. Enjoy!

  • Fixed an issue where changing the timezone on the web changes the time instead of the timezone
  • Fixed an issue where background task on iOS don't get triggered as often
  • Fixes some issues regarding the usage of self-signed certificate and mLTS on the mobile app

🐛 Bug fixes

📚 Documentation

  • docs: update manual backup/restore to match the automatic process by @insertish in #25924
  • fix(docs): add missing --json-output arg to CLI example by @Xiol in #25870
  • docs: remove writeTimeout on traefik example by @kaysond in #25837

🌐 Translations

New Contributors

Full Changelog: v2.5.3...v2.5.5

v2.5.3

03 Feb 23:00

Choose a tag to compare

What's Changed

🐛 Bug fixes

📚 Documentation

Full Changelog: v2.5.2...v2.5.3

v2.5.2

29 Jan 15:24

Choose a tag to compare

v2.5.2

v2.5.1 has been sacrificed for the release God, so the Android app can now be released

Note

This version of the mobile app will pull down some data from the server to fix the incorrect data in the mobile app local database, so you will see the sync icon running for a little bit

Hotfixes

  • Fixed a bug where the video aspect ratio is played incorrectly for the remote asset
  • Fixed a bug where memory generation failed
  • Fixed a bug where memories don't show on the web until the page is refreshed
  • Fixed a bug where the Load original image option doesn't render the image on iOS

What's Changed

🐛 Bug fixes

Full Changelog: v2.5.0...v2.5.2

v2.5.0 - 90000 Stars Release

27 Jan 19:51

Choose a tag to compare

v2.5.0

Note

01/27

  • 20:23 GMT: We are halting the release of the mobile app as there are some reported issues with migration
  • 22:00 GMT: Found the issue with the migration for the experimental sync-delete feature on Android. Will fix and release a new update soon. ETA tomorrow CTS time
  • 22:24 GMT: iOS is released as the migration doesn't affect iOS users

01/28

  • Discovered some annoyance bugs regarding editing after ready to release v2.5.1, so spent the whole day fixing them and will release v2.5.2 on Thursday (01/29)

Sorry for the inconvenience

Highlights

Happy New Year! Welcome to Immich v2.5.0. This release is our fireworks to celebrate both the new year and reaching 90,000 stars on GitHub. It is packed with major features that have been in the works for quite some time, and the team has kicked off the year with incredible momentum that we're excited to carry forward. We couldn't wait to share this with you. Let's dive right in:

  • Free Up Space
  • Non-destructive editing
  • Database backup and restore (web)
  • Upload improvements
  • Visual refresh across all platforms
  • Disable admin setup
  • Star rating (mobile)
  • Additional fine-grained permissions (api keys)
  • Progressive JPEGs
  • Slideshow loop option (web)
  • Native HTTP clients for HTTP/2 and HTTP/3 image loading

Free Up Space

This feature was requested ages ago. So long in fact, that it has a 3-digit ID (#165)! Given the rapid iteration and development pace of the pre-stable era, it was risky to include it in the app due to its bulk-delete nature. But it is now 2026 😄, so here we are.

Free Up Space allows you to remove local media files from your device that have already been successfully backed up to your Immich server (and are not in Immich trash). This helps reclaim storage on your mobile device without losing your memories. The feature can be accessed from the user profile panel or from the Settings page in the mobile app.

image image

There are configuration options and steps to make sure that everything is verified before deleting from the app.

  1. Configuration:
    • Cutoff date: Free Up Space will only look for photos and videos on or before this date.
    • Keep albums: Hold all photos and videos in the selected albums on your device, regardless of other settings. By default, **WhatsApp** related albums are selected to be kept on the device. Assets that are not already on the device will not be redownloaded.
    • Keep favorites: This works the same way **Keep albums** . By default, favorited assets are preserved on your device.
    • Keep on device: You can choose to restrict removal to **Always keep** All photos or All videos, regardless of other settings. This setting can hamper freeing up space significantly — with 80 GB of videos and 40 GB of photos, selecting **Always keep photos** retains thousands of photos on your device.

Tip

These configurations are persistent to make it convenient for those who perform this task often.

  1. Scan & Review: Before any files are removed, you are presented with a review screen to confirm which items will be deleted and how much storage will be reclaimed.
  2. Deletion: Confirmed items are moved to your device's native Trash/Recycle Bin.

Note

Reclaim storage
To use the reclaimed space right away, you must manually empty the system/gallery trash outside Immich.

For more information about this feature, please read it here

Non-destructive editing

Immich now supports non-destructive photo editing. This means that any edits you make to an asset do not modify the original file; instead, the modifications are stored in the database, and new thumbnails are generated based on those changes. This means you can always revert to the original asset if needed.

When you download an edited asset, Immich provides the edited version by default. However, you can choose to download the original version if needed. Immich always generates an edited full-size version based on your full-size quality settings. This occurs regardless of whether the "Enable full-size image generation" setting is enabled or disabled.

Note

Limitations:

  • Mobile clients must be updated to v2.5.0 in order view the edited version of an asset. Clients will continue to > see the original asset if on a mobile app version <2.5.0
  • As of this version, the edited download won't include the EXIF metadata of the original asset. This feature will come in future releases.
  • Mobile editing still uses the old edit system (saving a new version of the photo). The mobile editor will be upgraded to use the new non-destructive editing system in a future release.

You can click on the following icon to enter edit mode

image

Currently, Immich supports the following types of edits:

  • Cropping
  • Rotation
  • Mirroring
image

Opening the editor on an edited asset will load the existing edits back in so you can make adjustments and changes.

image

Backup and restore from the web UI

Backup and restore are an important part of any self-hosted application; this feature helps you maintain reliable access to your instance during unexpected events, such as database corruption caused by system failure or power loss.

Historically, restoring an Immich instance to a specific point required the user to have access to the command line, which proved challenging for many users, especially those new to self-hosting and software maintenance.

Now, we have the entire backup and restore pipeline built into Immich, which allows you to quickly restore a database backup directly from the web UI. You can perform the steps either from the Administration > Maintenance page, or from a brand new instance on the welcome page.

Restore from Administration's Maintenance page

image

Restore from Onboarding page

image

For more detailed steps, please read them in our documentation

Upload improvement

This release also improves foreground upload in the mobile app. The previous implementation improves background uploads but leaves foreground uploads less reliable by leveraging the queue system to offload upload handling to the OS, which can be throttled under specific criteria.

We are taking back more control over handling uploads with the try-and-true method used in the old timeline, but this time it is supercharged with concurrent uploads and also correctly handles assets with missing file extensions from software such as DJI or Fusion Camera.

image

Upload now will also send unique metadata for each asset to the server, so it can be used to quickly retrieve the checksum when reinstalling the app, saving time and CPU resources. This is especially useful for iCloud users, as the hashing process can take a long time.

For iOS and iCloud users, it is recommended to go to App Settings > Sync Status and tap the "Sync Cloud IDs" button to backfill the metadata for the uploaded content. You only need to do this once.

image

Visual refresh across all platforms

This release also brings you a refreshed look and feel across the web, mobile app, and the documentation sites, with a new font face ("The-name-must-not-be-named" Sans) that improves reading legibility, especially for numbers and smaller text.

image

The UI library (https://ui.immich.app/) components have also been added to the web app in more places. You should see a more standardized, coherent, and better hierarchy for UI components across the app.

image

All icon buttons now come with a tooltip, so you don't have to guess what function the button serves

image

Star rating (mobile)

Mobile now has the star-rating feature, similar to the web application. If you don't see a star rating on either platform, make sure the feature is enabled here.

image

Disable admin setup

New installs show a welcome page and allow anyone to sign up / register as an admin. To have more control over whether this is allowed or not, we have added the following environment variable:

IMMICH_ALLOW_SETUP=true|false

This is especially useful if you have already initialize...

Read more

v2.4.1

19 Dec 15:50

Choose a tag to compare

2.4.1

What's Changed

🐛 Bug fixes

📚 Documentation

New Contributors

Full Changelog: v2.4.0...v2.4.1

v2.4.0

18 Dec 14:51

Choose a tag to compare

v2.4.0

Highlights

Welcome to the release v2.4.0 of Immich. This release focuses on bug fixes, QoL improvements, and polished UI components and animation across mobile and the web. Let’s dive right in.

  • Show the owner's name in the shared album
  • Command palette
  • Change search type directly in the search bar
  • Better action button placement in the mobile asset viewer
  • Notable fix: fix an issue where metadata extraction could fail on high concurrency

Show the owner's name in the shared album.

On the web, in shared albums, you can now toggle an option to display the asset’s owner name at the bottom right corner of the thumbnail.

asset owner name in album

Command palette

The web app now has an integrated command palette, which can be opened ctrl + k on Windows/Linux or cmd + k on macOS. This first iteration of this lets you quickly navigate between administration pages by typing the name of the page you want to go to. It also already supports some common actions when on the respective admin pages, many of which also support shortcuts. Have a look around and check them out!

command pallet

Change search type directly in the search bar

You can now click on the pill from the search bar to select a different search type without opening the search filter panel.

search type

Better placement of action buttons in the mobile asset viewer

Previously, to perform a specific action on the asset, you needed first to swipe up to open the detail panel, then swipe all the way to the right and tap the action. It limits the discoverability of some actions. To help resolve that issue, all the action buttons in the detail panel are now moved to the drop-down menu when tapping on the vertical dot icon (or kebab menu), along with some buttons that used to be on the top bar, clearing up space to display more helpful information when viewing the asset.

kebab menu

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

🫥 Deprecated Changes

🚀 Features

🌟 Enhancements

🐛 Bug fixes

Read more

v2.3.1

20 Nov 03:10

Choose a tag to compare

v2.3.1

Hot fixes

Fixed an issue where the new version notification pop-up causes the web app to enter a rendering loop and freeze up.

Important

We encourage all users to update to this version to avoid the issue that will happen when the next minor update is available, i.e., v2.4.0

What's Changed

🐛 Bug fixes

Full Changelog: v2.3.0...v2.3.1

v2.3.0

19 Nov 22:36

Choose a tag to compare

v2.3.0

Loa loa loa, the stock is running low on 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!

image

Important

We will start the work on removing the old mobile timeline soon. If you are still using the old timeline, please make sure to switch to the new timeline. If this message does not make sense to you, you can ignore it as you are already on the new timeline

Highlights

Welcome to the release v2.3.0 of Immich. This version comes with enhancements to the OCR feature and many bug fixes. This release also introduces foundational support for workflows and an application restore mechanism directly in the web UI. Let’s dive into some of the highlights below

  • OCR Improvements
  • Add/move action in mobile app
  • Delete synchronization - Android
  • Notable fixes: app freezes on resume on iOS
  • Sneak peek: Maintenance mode and workflow

Add/move action in mobile app

The asset viewer in the mobile app now includes an “Add to” button that lets you quickly add an asset to an album, the locked folder, or the archive. Thanks @happychriss!

Tapping the Add to button presents a menu to add/move an asset

OCR Improvement

This release includes several enhancements to the OCR feature. There are now language-specific OCR model variants, extending support to Greek, Korean, Russian, Belarusian, Ukrainian, Thai, and languages using the Latin script. All variants (including the existing models) support English as well. There is also an English-only model that performs better for libraries where multilingual support is not needed.

To switch to one of these models, you can navigate to the OCR settings, choose the relevant model, save, then re-run OCR on all assets through the Job Status page.

image

The OCR information can now be viewed by toggling a button in the web viewer. You can hover the mouse over the text and copy it.

image

Delete synchronization on Android.

This release restores the previous mechanism for synchronizing the deletion action between the web and the mobile app. In addition to putting the asset in Immich’s trash bin, the mechanism also puts the deleted asset in the device’s trash system when the app opens. The mechanism has been reworked to align with the new data sync mechanism in the mobile app. You can enable the mechanism in the App Settings > Advanced > Sync Remote Deletions

image

Notable fixes: app freezes on resume on iOS

Previously, iOS background tasks, such as local or remote data sync and background uploads, could abruptly terminate database operations when the iOS’s background time expires, leaving the database lock unreleased. It leads to an annoying symptom: the app appears to freeze when opening from the background, requiring a hard restart (swipe up to close, then reopen) to regain access to the database. The bug happened sporadically and was incredibly hard to track down. Thanks to the relentless pursuit of the bug, we believe it has been caught through our extensive testing. Please let us know if you are still getting “bugged” by this one in the new version.

Sneak peek: Maintenance mode and workflow

We can’t contain the excitement to share two exciting items in the work, which have some portions already merged into the server, and are ready to be built upon

Maintenance mode

This mode will allow the admin to put the server into a state where no one can access it without entirely shutting it down. This paves the way for restoring the server from a previous point in time directly from the web UI, no more fidgeting with the terminal.

2025-11-14_11-55-02.mp4

Workflow

The foundation of workflows and plugins also made its way to the server; the UI is being worked on. This feature will enable many more custom use cases that are not available in the core application. The community can write custom plugins and share them. We are very excited to see this happening faster than anticipated. Below is a screenshot of how the feature could look.

image image

What's Changed

🚀 Features

🌟 Enhancements

🐛 Bug fixes

Read more

v2.2.3

05 Nov 13:47

Choose a tag to compare

v2.2.3

What's Changed

🐛 Bug fixes

New Contributors

Full Changelog: v2.2.2...v2.2.3