# Immich changelog
> A self-hosted photo and video backup solution.
- Vendor: Immich
- Category: Media
- Official site: https://immich.app
- Tracked by: What's New (https://whatsnew.fyi/product/immich)
- Harvested from: GitHub (immich-app/immich)
- Entries below: 10 (newest first)
What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.
## Releases
### v3.1.0
- Date: 2026-07-29
- Version: v3.1.0
- Original notes: https://github.com/immich-app/immich/releases/tag/v3.1.0
- Permalink: https://whatsnew.fyi/product/immich/releases/v3.1.0
- **removed** — Drop support for iOS 14
- **added** — Add --visibility flag to immich CLI upload subcommand
- **added** — Custom date range for map on mobile
- **changed** — Keep show more open on duplicates
- **fixed** — Add trigger for external libraries AssetCreate in workflows
- **added** — Add wake lock when uploading assets on web
- **added** — Undo archive from toast notification
- **added** — Filter workflow assets by upload path
- **added** — Add maintenance link to command palette
- **added** — Add album asset event handling
- **fixed** — Improve slideshow controls visibility on bright backgrounds
- **changed** — Re-evaluate OIDC role claim on every login and support array values
- **added** — Add EXIF metadata workflow filter
- **added** — Add option to invalidate sessions when resetting password via admin-cli
- **fixed** — Apply EXIF orientation to remote raw photos on Android
- **fixed** — Hide stack thumbnail tray in slideshow mode
Welcome to Immich `v3.1.0`!
This release includes several quality of life improvements and another round of bug fixes. Keep reading below for the complete highlights.
##### Highlights
- Upload wakelock (web)
- Undo archive (web)
- Filter assets by server filepath (workflows)
- Quick navigate to maintenance page (web)
- Better slideshow button accessibility (web)
- OIDC role claim sync improvements (OAuth)
- Invalidate sessions on password reset (admin-cli)
###### Upload wakelock (web)
Similar to mobile, the web application will now automatically acquire a wakelock to prevent the screen from dimming while uploads are happening. This feature will require an HTTPS connection.
###### Undo archive (web)
After archiving assets, the success notification now has an “undo” button to undo the action.
###### Filter assets by server filepath (workflows)
The asset file filter has a new option “Use path”. When set to true, it will filter based on the actual path on the server rather than the original file name.
###### Filter assets by EXIF metadata (workflows)
A new workflow filter has been added that allows you to filter assets based on their EXIF metadata fields. For now it only supports string comparisons, with numerical comparisons expected to come soon.
###### Quick navigate to maintenance page (web)
The command palette (`CTRL+K` or `/`) now includes an item for the maintenance page.
###### Better slideshow button visibility (web)
The slideshow buttons on the web are now wrapped in a container with a backdrop blur, making them easier to view when the current asset is very light.
###### OIDC role claim sync improvements (OAuth)
The OAuth integration in Immich supports setting an initial `isAdmin` value for new users via a role claim. This same process has been updated to now _sync_ `isAdmin` on subsequent logins. Additionally, the role claim now supports both single values (`immich_role: 'admin'`) in addition to lists of values ( `immich_role: ["admin", "user"]`), making in more flexible.
###### Invalidate sessions on password reset (admin-cli)
When using the admin command line interface to reset a password, there is now a new option to invalidate existing sessions.
```none
immich-admin reset-admin-password
Found Admin:
- ID=e65e6f88-2a30-4dbe-8dd9-1885f4889b53
- OAuth ID=
- Email=admin@example.com
- Name=Immich Admin
? Please choose a new password (optional) immich-is-cool
? Invalidate existing sessions? Yes
The admin password has been updated.
```
###### Date range for map (mobile)
Similar to web, mobile now also supports filtering the map for assets within a given date range.
---
##### What's Changed
###### 🚨 Breaking Changes
- chore(mobile): drop support for iOS 14 by @agg23 in
###### 🚀 Features
- feat(cli): Add --visibil
_[Truncated at 4000 characters — full notes: https://github.com/immich-app/immich/releases/tag/v3.1.0]_
### v3.0.3
- Date: 2026-07-15
- Version: v3.0.3
- Original notes: https://github.com/immich-app/immich/releases/tag/v3.0.3
- Permalink: https://whatsnew.fyi/product/immich/releases/v3.0.3
- **added** — Publish app releases to FUTO F-Droid repo
- **changed** — F-Droid users should pull the application from https://app.futo.org/fdroid/repo instead of the standard F-Droid repository
- **fixed** — Issue where LivePhotos upload from the background isn't showing up
- **fixed** — Closing plugin method picker selects unknown method on web
- **fixed** — Unauthorized album owner update
- **fixed** — System appbar icon color has incorrect color in asset viewer
- **fixed** — Locked visibility in search random endpoint
- **fixed** — Send a full datetime from the Android memories widget
- **fixed** — Memory search date validation
- **fixed** — Set hvc1 tag when using hwa
- **fixed** — Clear zoom state when swapping assets on mobile
- **fixed** — Ken Burns effect on sliver app bar jittery on Android
- **fixed** — Correct person age singular pluralization in mobile translations
#### v3.0.3
- various bug fixes
- we push to our own F-Droid repo at https://app.futo.org/fdroid/repo now. If you're using F-Droid, please pull the application from there from now on
- fixes an issue where LivePhotos upload from the background isn't showing up.
> [!Note]
> In some specific circumstances, newly uploaded Live Photos could have broken thumbnails. If you see any such cases, please run the "missing" job for thumbnails or wait for the respective nightly job to clear it up.
##### What's Changed
###### 🚀 Features
* feat: publish app releases to FUTO F-Droid repo by @bo0tzz in https://github.com/immich-app/immich/pull/29804
###### 🐛 Bug fixes
* fix(web): closing plugin method picker selects "unknown" method by @benbeckford in https://github.com/immich-app/immich/pull/29784
* fix: unauthorized album owner update by @danieldietzler in https://github.com/immich-app/immich/pull/29883
* fix: still part of live photo hidden on bg upload by @shenlong-tanwen in https://github.com/immich-app/immich/pull/29884
* fix: system appbar icon color has incorrect color in asset viewer by @alextran1502 in https://github.com/immich-app/immich/pull/29885
* fix: locked visibility in search random endpoint by @danieldietzler in https://github.com/immich-app/immich/pull/29887
* fix(mobile): send a full datetime from the android memories widget by @santoshakil in https://github.com/immich-app/immich/pull/29689
* fix: memory search date validation by @danieldietzler in https://github.com/immich-app/immich/pull/29907
* fix(server): set hvc1 tag when using hwa by @mertalev in https://github.com/immich-app/immich/pull/29908
* fix(mobile): clear zoom state when swapping assets by @agg23 in https://github.com/immich-app/immich/pull/29909
* fix: Ken Burns effect on sliver app bar jittery on Android by @alextran1502 in https://github.com/immich-app/immich/pull/29890
###### 📚 Documentation
* fix(docs): update fdroid link by @mmomjian in https://github.com/immich-app/immich/pull/29797
* feat: system integrity docs by @danieldietzler in https://github.com/immich-app/immich/pull/29911
###### 🌐 Translations
* chore(web): update translations by @weblate in https://github.com/immich-app/immich/pull/29774
* fix(mobile): correct person age singular pluralization by @tech00exploere in https://github.com/immich-app/immich/pull/29868
##### New Contributors
* @tech00exploere made their first contribution in https://github.com/immich-app/immich/pull/29868
**Full Changelog**: https://github.com/immich-app/immich/compare/v3.0.2...v3.0.3
### v3.0.2
- Date: 2026-07-09
- Version: v3.0.2
- Original notes: https://github.com/immich-app/immich/releases/tag/v3.0.2
- Permalink: https://whatsnew.fyi/product/immich/releases/v3.0.2
- **added** — HLS variant configuration
- **added** — User agnostic database restore
- **added** — Date workflow filter
- **fixed** — Re-add gCastEnabled negation
- **fixed** — Downmix audio to stereo to fix broken channel layout
- **fixed** — Live transcoding when viewing from a link share
- **fixed** — Web search timeline visibility
- **fixed** — Missing i18n strings
- **fixed** — Chinese browser locales recognition
- **fixed** — 10-bit heic and avif colors on Android
- **fixed** — Mobile scroll to top and tabbar scroll behavior
- **fixed** — Wrap migrations in transaction
- **fixed** — OAuth account linking
- **fixed** — Incorrect grouping of recently added assets
- **fixed** — Integrity checks checksum pagination
- **fixed** — Missing crop options and rotation scaling on mobile
- **fixed** — Properly handle live photos locally on mobile
- **fixed** — Integrity checks dto validation
- **fixed** — HTTP request handling after isolate death on mobile
#### v3.0.2
This patch release addresses various bugs from v3 release and adds an additional filter to workflows
##### What's Changed
###### 🌟 Enhancements
* fix(web): add ARIA label to ServerStatisticsCard by @tjhorner in https://github.com/immich-app/immich/pull/29497
* feat(server): hls variant configuration by @mertalev in https://github.com/immich-app/immich/pull/29613
* feat: user agnostic database restore by @danieldietzler in https://github.com/immich-app/immich/pull/29512
* feat(server): date workflow filter by @benbeckford in https://github.com/immich-app/immich/pull/29040
###### 🐛 Bug fixes
* fix: re-add gCastEnabled negation by @bo0tzz in https://github.com/immich-app/immich/pull/29499
* fix: downmix audio to stereo to fix broken channel layout by @lukasdotcom in https://github.com/immich-app/immich/pull/29485
* fix: live transcoding when viewing from a link share by @lukasdotcom in https://github.com/immich-app/immich/pull/29471
* fix: web search timeline visibility by @danieldietzler in https://github.com/immich-app/immich/pull/29518
* fix(web): missing i18n strings by @wonsukchoi in https://github.com/immich-app/immich/pull/29612
* fix: chinese browser locales recognition by @danieldietzler in https://github.com/immich-app/immich/pull/29622
* chore: improve added to album messages by @danieldietzler in https://github.com/immich-app/immich/pull/29641
* fix(mobile): fix 10-bit heic and avif colors on android by @santoshakil in https://github.com/immich-app/immich/pull/29631
* fix(mobile): match iOS scroll to top and tabbar scroll (#28469) by @agg23 in https://github.com/immich-app/immich/pull/29705
* fix: wrap migrations in transaction by @shenlong-tanwen in https://github.com/immich-app/immich/pull/29664
* fix: oauth account linking by @danieldietzler in https://github.com/immich-app/immich/pull/29624
* fix: incorrect grouping of recently added assets by @benbeckford in https://github.com/immich-app/immich/pull/29666
* fix: integrity checks checksum pagination by @danieldietzler in https://github.com/immich-app/immich/pull/29516
* fix(mobile): missing crop options and rotation scaling by @bwees in https://github.com/immich-app/immich/pull/29645
* fix(mobile): properly handle live photos locally by @agg23 in https://github.com/immich-app/immich/pull/29462
* fix: integrity checks dto validation by @danieldietzler in https://github.com/immich-app/immich/pull/29621
* fix(mobile): http request handling after isolate death by @mertalev in https://github.com/immich-app/immich/pull/29714
* fix: do not log out on automatic url switch by @shenlong-tanwen in https://github.com/immich-app/immich/pull/29715
* fix(server): stream ffprobe packets by @mertalev in https://github.com/immich-app/immich/pull/29723
* fix: search metadata for album shared links by @danieldietzler in https://github.com/immich-app/immich/pull/29742
* fix(web): clear asset selection when search context changes by @khanguyen74 in https://github.com/immich-app/immich/pull/29738
* fix(mobile): update timeline args on layout constraint changes by @santoshakil in https://github.com/immich-app/immich/pull/29653
* fix: iso date parsing for three digit years by @danieldietzler in https://github.com/immich-app/immich/pull/29739
* fix: missing files integrity checks by @danieldietzler in https://github.com/immich-app/immich/pull/29737
* fix(mobile): play videos from search results and folder view by @santoshakil in https://github.com/immich-app/immich/pull/29693
* fix(web): recursively unnest class arrays by @meesfrensel in https://github.com/immich-app/immich/pull/29755
* fix: emit album update event when uploading assets through shared link by @danieldietzler in https://github.com/immich-app/immich/pull/29757
* fix(web): always initialize language manager to set lang and dir by @meesfrensel in https://github.com/immich-app/immich/pul
_[Truncated at 4000 characters — full notes: https://github.com/immich-app/immich/releases/tag/v3.0.2]_
### v3.0.1
- Date: 2026-07-02
- Version: v3.0.1
- Original notes: https://github.com/immich-app/immich/releases/tag/v3.0.1
- Permalink: https://whatsnew.fyi/product/immich/releases/v3.0.1
- **added** — Add recently added link in sidebar on web
- **fixed** — Fix albums broken on v2 mobile clients
- **fixed** — Fix setting input field description spacing for description snippet
#### v3.0.1
- Fixes a bug that causes albums don't show up in the mobile app
##### What's Changed
###### 🚀 Features
* feat(web): recently added link in sidebar by @benbeckford in https://github.com/immich-app/immich/pull/29039
###### 🐛 Bug fixes
* fix: albums broken on v2 mobile clients by @shenlong-tanwen in https://github.com/immich-app/immich/pull/29446
* fix: setting input field description spacing for description snippet by @danieldietzler in https://github.com/immich-app/immich/pull/29433
###### 🌐 Translations
* chore(web): update translations by @weblate in https://github.com/immich-app/immich/pull/29410
**Full Changelog**: https://github.com/immich-app/immich/compare/v3.0.0...v3.0.1
### v3.0.0
- Date: 2026-07-02
- Version: v3.0.0
- Original notes: https://github.com/immich-app/immich/releases/tag/v3.0.0
- Permalink: https://whatsnew.fyi/product/immich/releases/v3.0.0
- **added** — Mobile non-destructive editing with cropping, rotating, and adjusting images without modifying the original file
- **added** — Workflows preview feature to automate actions in your library by chaining triggers, filters, and actions together with a drag-and-drop builder
- **added** — Recently added page
- **added** — Integrity checks
- **added** — Slideshow on mobile app
- **added** — HLS and real-time video transcoding in preview
- **added** — New video player for web
- **added** — Open photo in Immich as gallery on Android
- **added** — OCR on mobile app
- **added** — Upload asset directly to album on the mobile app
- **added** — Option to select image size when sharing on the mobile app
- **changed** — Background backup improvement
- **changed** — Timeline performance improvement for browsing a large amount of assets in a single month
- **removed** — Recoloring photos from mobile editing
- **removed** — Editing live photos on mobile
- **removed** — Editing local assets on mobile
- **removed** — Support for pgvecto.rs
#### v3.0.0
Welcome to Immich `v3.0.0`!
After months of hard work from the team and our amazing contributors, we're thrilled to announce the next major version of Immich: `v3.0.0`! 🎉
##### Breaking changes
This release includes several breaking changes; read the full migration guide [here](https://immich.app/blog/v3-migration). *It's worth mentioning that many of the breaking changes are updates to API endpoints and affect only **third-party tools** that integrate with Immich's API*. For the vast majority of users, updating works exactly as it always has.
##### How to update
> [!WARNING]
> `v3.0.0` drops support for pgvecto.rs. If you run Immich before `v1.133.0` and haven't done the migration step yet, see the migration guide here. https://docs.immich.app/install/upgrading/#migrating-to-vectorchord
First, update the `IMMICH_VERSION` in your `.env` file to `v3`:
```diff
- IMMICH_VERSION=v2
+ IMMICH_VERSION=v3
```
Then run the usual update commands:
```bash
docker compose pull && docker compose up -d
```
##### Release candidates
If you missed it, `v3.0.0` was the first time we used release candidates, also known as prereleases. Release candidates are tested but not yet official releases of Immich, and they allow us to find and fix any outstanding bugs before a final release. If you would like to be notified about release candidates directly through Immich, you can change the release channel from "Stable" to "Release candidate" in the `Admin settings > Version check` options ([here](https://my.immich.app/admin/system-settings?isOpen=version-check)).
##### New Merch
As part of this release, we're happy to announce we also have some new swag for you!
* Kids clothing: For those who are likely the reason for your Immich library's size
* Colored embroidery: We now have clothes with a full color embroidered Immich logo
Check it out now at [https://immich.store](https://immich.store/collections/immich-3-0)!
##### Highlights
Now, let's get right into all the new features in this release:
* Mobile non-destructive editing
* Workflows (preview)
* Background backup improvement
* Recently added page
* Integrity checks
* Slideshow on mobile app
* HLS and real-time video transcoding (preview)
* New video player for web
* Open photo in Immich as gallery on Android
* OCR on mobile app
* Upload asset directly to album on the mobile app
* Option to select image size when sharing on the mobile app
* Timeline performance improvement for browsing a large amount of assets in a single month
###### Mobile non-destructive editing
This is a follow-up to Image Editing on the web, which was released in `v2.5.0`. This feature allows you to make non-destructive edits to your photos inside of Immich. Until now, the mobile editor used a completely different system that created new assets instead of editing the photo in place.
With this update, we bring a new, easier-to-use editor to mobile devices that has the same features as the web version. You can now edit photos directly in the mobile app, including cropping, rotating, and adjusting your images without ever touching the original file. Similar to the web, edits are non-destructive, so you can revisit or revert them at any time. You can even make edits on mobile and then adjust them on the web later!
Some features from the previous mobile editing implementation have been removed including:
* Recoloring photos
* Edit
_[Truncated at 4000 characters — full notes: https://github.com/immich-app/immich/releases/tag/v3.0.0]_
### v3.0.0-rc.3
- Date: 2026-06-26
- Version: v3.0.0-rc.3
- Original notes: https://github.com/immich-app/immich/releases/tag/v3.0.0-rc.3
- Permalink: https://whatsnew.fyi/product/immich/releases/v3.0.0-rc.3
- Labels: Pre-release
- **added** — Keyboard seeking for new video player
- **added** — Text white shadow to elements with increased shadow effects
- **added** — Webhook workflow action
- **fixed** — Detail panel people reactivity and iterator consumption
- **fixed** — Use VBR for QSV so the max bitrate is respected
- **fixed** — Ignore external libraries for integrity report checksum check
- **fixed** — Remove map's fullscreen button
- **fixed** — Sync backfill
- **fixed** — Force AssetViewerPage recreation on repeated view intents on mobile
- **fixed** — Blank notifications page after enabling notifications on mobile
- **fixed** — App doesn't exit full-screen mode on mobile
- **fixed** — Only toggle backup from the switch, not the whole row on mobile
> \[!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.
This third release candidate `v3.0.0-rc.3` fixes bugs and issues that were found in the last release candidate.
###### Release notes
Work-in-progress release notes can be found here:
###### Server
To use this RC version on the server, update the `IMMICH_VERSION` in your `.env` file:
```
IMMICH_VERSION=v3.0.0-rc.3
```
or
```
IMMICH_VERSION=v3-rc
```
Then pull and restart:
```bash
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:
If you run into any issues, please report them on [GitHub](https://github.com/immich-app/immich/issues) 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: keyboard seeking for new video player by @danieldietzler in https://github.com/immich-app/immich/pull/29208
* feat(web): Add text-white-shadow to elements and increase the shadows effect by @Vogeluff in https://github.com/immich-app/immich/pull/29165
* feat: webhook workflow action by @benbeckford in https://github.com/immich-app/immich/pull/29258
###### 🐛 Bug fixes
* fix: detail panel people reactivity and iterator consumption by @danieldietzler in https://github.com/immich-app/immich/pull/29250
* fix(server): use VBR for QSV so the max bitrate is respected by @aclerici38 in https://github.com/immich-app/immich/pull/29240
* fix: ignore external libraries for integrity report checksum check by @danieldietzler in https://github.com/immich-app/immich/pull/29248
* fix(web): remove map's fullscreen button by @meesfrensel in https://github.com/immich-app/immich/pull/29192
* refactor: use SemVer classes for version compatability message by @bwees in https://github.com/immich-app/immich/pull/29056
* fix: sync backfill by @jrasm91 in https://github.com/immich-app/immich/pull/29267
* fix(mobile): force AssetViewerPage recreation on repeated view intents by @okxint in https://github.com/immich-app/immich/pull/29235
* fix(mobile): blank notifications page after enabling notifications by @santoshakil in https://github.com/immich-app/immich/pull/29232
* fix(mobile): app doesn't exit full-screen mode by @YarosMallorca in https://github.com/immich-app/immich/pull/29301
* fix(mobile): only toggle backup from the switch, not the whole row by @santoshakil in https://github.com/immich-app/immich/pull/29236
###### 📚 Documentation
* docs: clarify duplicate exif merging intent by @timonrieger in https://github.com/immich-app/immich/pull/29203
* fix(docsc): v3 bump by @mmomjian in https://github.com/immich-app/immich/pull/29246
* docs: MS smtp guide by @jameskimmel in https://github.com/immich-app/immich/pull/29289
###### 🌐 Translations
* fix: turkish readme translation by @MuySup in https://github.com/immich-app/immich/pull/29234
* chore(web): update translations by @weblate in https://github.com/immich-app/immich/pull/29204
* chore(web): updat
_[Truncated at 4000 characters — full notes: https://github.com/immich-app/immich/releases/tag/v3.0.0-rc.3]_
### v3.0.0-rc.2
- Date: 2026-06-19
- Version: v3.0.0-rc.2
- Original notes: https://github.com/immich-app/immich/releases/tag/v3.0.0-rc.2
- Permalink: https://whatsnew.fyi/product/immich/releases/v3.0.0-rc.2
- Labels: Pre-release
- **fixed** — Skip existing users when sharing albums
- **fixed** — Web i18n
- **fixed** — Shift+click on GPS asset extends range selection in geolocation utility
- **fixed** — Allow non-UTC datetime offsets
- **fixed** — Remove local-only step ids from workflow json
- **fixed** — Asset type filter
- **fixed** — Prevent duplicate login pages for unauthenticated share intent warm start on mobile
- **fixed** — Refresh memories on resume and day change on mobile
- **fixed** — Re-lock locked folder when the app is backgrounded on mobile
- **fixed** — Endless spinner on album selection when device has no albums on mobile
- **fixed** — RC version check
> \[!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.
This second release candidate `v3.0.0-rc.2` fixes bugs and issues that were found in the last release candidate.
###### Release notes
Work-in-progress release notes can be found here:
###### Server
To use this RC version on the server, update the `IMMICH_VERSION` in your `.env` file:
```
IMMICH_VERSION=v3.0.0-rc.2
```
or
```
IMMICH_VERSION=v3-rc
```
Then pull and restart:
```bash
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**
We are currently having issues with the iOS release. Expect a new version on TestFlight to land early next week at the latest:
If you run into any issues, please report them on [GitHub](https://github.com/immich-app/immich/issues) so we can address them before the final release. Thank you for helping us test!
##### What's Changed
###### 🐛 Bug fixes
* fix(server): skip existing users when sharing albums by @jeevan6996 in https://github.com/immich-app/immich/pull/28884
* fix: web i18n by @danieldietzler in https://github.com/immich-app/immich/pull/29175
* fix(web): shift+click on GPS asset extends range selection in geolocation utility by @timonrieger in https://github.com/immich-app/immich/pull/29022
* fix(server): allow non-utc datetime offsets by @timonrieger in https://github.com/immich-app/immich/pull/29186
* fix: remove local-only step ids from workflow json by @danieldietzler in https://github.com/immich-app/immich/pull/29188
* fix: asset type filter by @danieldietzler in https://github.com/immich-app/immich/pull/29190
* fix(mobile): prevent duplicate login pages for unauthenticated share intent warm start by @olildu in https://github.com/immich-app/immich/pull/29054
* fix(mobile): refresh memories on resume and day change by @santoshakil in https://github.com/immich-app/immich/pull/28983
* fix(mobile): re-lock locked folder when the app is backgrounded by @santoshakil in https://github.com/immich-app/immich/pull/29089
* fix(mobile): endless spinner on album selection when device has no albums by @santoshakil in https://github.com/immich-app/immich/pull/28994
* fix: rc version check by @danieldietzler in https://github.com/immich-app/immich/pull/29194
###### 📚 Documentation
* docs(mobile-app): add Play App Signing certificate hash by @tlvince in https://github.com/immich-app/immich/pull/29168
* docs(mobile): point users towards shared setup docs by @agg23 in https://github.com/immich-app/immich/pull/29078
###### 🌐 Translations
* chore(web): update translations by @weblate in https://github.com/immich-app/immich/pull/29162
##### New Contributors
* @jeevan6996 made their first contribution in https://github.com/immich-app/immich/pull/28884
* @rizwanpatel-gif made their first contribution in https://github.com/immich-app/immich/pull/29172
* @olildu made their first contribution in https://github.com/immich-app/immich/pull/29054
**Full Changelog**: https://github.com/immich-app/immich/compare/v3.0.0-rc.1...v3.0.0-rc.2
### v3.0.0-rc.1
- Date: 2026-06-17
- Version: v3.0.0-rc.1
- Original notes: https://github.com/immich-app/immich/releases/tag/v3.0.0-rc.1
- Permalink: https://whatsnew.fyi/product/immich/releases/v3.0.0-rc.1
- Labels: Pre-release
- **changed** — Show album names in duplicate review
- **fixed** — Show like and comment options on album photo deep links
- **fixed** — Correctly handle person search with more than 100 results
- **fixed** — Prevent upload status panel from overlapping album action bar
- **fixed** — Error loading image state
- **fixed** — Show asset arrows
- **fixed** — Hide partner archived asset locations from map
- **fixed** — Lock transcoding options
- **fixed** — Do not merge metadata when multiple duplicates are kept
- **fixed** — Integrity report checksum query
- **fixed** — Map settings
- **fixed** — Too strict cron expression validation
- **fixed** — Respect local timezone when building date range for search
- **fixed** — Language selector
- **fixed** — Update datetimeRelative description to minutes instead of seconds
- **fixed** — Video thumbnail quality sharing
- **fixed** — Stop sync albums crashing on the main isolate
- **fixed** — Show memories with no showAt/hideAt in the timeline lane
- **fixed** — Keep toasts off the dynamic island when keyboard is open
- **added** — Add new languages
#### v3.0.0-rc.1 — Release Candidate
> \[!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.
This second release candidate `v3.0.0-rc.1` fixes bugs and issues that were found in the last release candidate. You can now use the release candidate tag `v3-rc` for all the prereleases under `v3`.
###### Release notes
Work-in-progress release notes can be found here:
###### Server
To use this RC version on the server, update the `IMMICH_VERSION` in your `.env` file:
```
IMMICH_VERSION=v3.0.0-rc.1
```
or
```
IMMICH_VERSION=v3-rc
```
Then pull and restart:
```bash
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**
Use the TestFlight link or scan the QR Code
If you run into any issues, please report them on [GitHub](https://github.com/immich-app/immich/issues) so we can address them before the final release. Thank you for helping us test!
##### What's Changed
###### 🌟 Enhancements
* fix(web): show album names in duplicate review by @meesfrensel in https://github.com/immich-app/immich/pull/29080
###### 🐛 Bug fixes
* fix(mobile): show like and comment options on album photo deep links by @santoshakil in https://github.com/immich-app/immich/pull/29020
* fix(web): correctly handle person search with more than 100 results by @maxinegardenas in https://github.com/immich-app/immich/pull/29002
* fix(web): prevent upload status panel from overlapping album action bar by @okxint in https://github.com/immich-app/immich/pull/29044
* fix(web): error loading image state by @bwees in https://github.com/immich-app/immich/pull/29058
* fix(web): show asset arrows by @timonrieger in https://github.com/immich-app/immich/pull/29010
* fix(server): hide partner archived asset locations from map by @timonrieger in https://github.com/immich-app/immich/pull/29028
* fix: lock transcoding options by @timonrieger in https://github.com/immich-app/immich/pull/29076
* fix(server): do not merge metadata when multiple duplicates are kept by @timonrieger in https://github.com/immich-app/immich/pull/29035
* fix: integrity report checksum query by @danieldietzler in https://github.com/immich-app/immich/pull/29136
* fix: map settings by @danieldietzler in https://github.com/immich-app/immich/pull/29134
* fix: too strict cron expression validation by @danieldietzler in https://github.com/immich-app/immich/pull/29138
* fix(web): respect local timezone when building date range for search by @okxint in https://github.com/immich-app/immich/pull/29128
* fix(web): language selector by @meesfrensel in https://github.com/immich-app/immich/pull/29065
* fix: update datetimeRelative description to minutes instead of seconds by @meesfrensel in https://github.com/immich-app/immich/pull/29137
* fix: video thumbnail quality sharing by @bwees in https://github.com/immich-app/immich/pull/29104
* fix(mobile): stop sync albums crashing on the main isolate by @santoshakil in https://github.com/immich-app/immich/pull/29133
* fix(mobile): show memories with no showAt/hideAt in the timeline lane by @santoshakil in https://github.com
_[Truncated at 4000 characters — full notes: https://github.com/immich-app/immich/releases/tag/v3.0.0-rc.1]_
### v3.0.0-rc.0
- Date: 2026-06-15
- Version: v3.0.0-rc.0
- Original notes: https://github.com/immich-app/immich/releases/tag/v3.0.0-rc.0
- Permalink: https://whatsnew.fyi/product/immich/releases/v3.0.0-rc.0
- Labels: Pre-release
- **removed** — Migrate class-validator to zod validation
- **removed** — Remove replace asset endpoint
- **removed** — Remove my shared link DTO
- **removed** — Remove deprecated environment variables
- **removed** — Remove getRandom API endpoint
- **removed** — Remove unused token response parameter
- **removed** — Remove old timeline sync endpoints
- **removed** — Remove deviceId and deviceAssetId
- **removed** — Remove /api/server/theme endpoint
- **changed** — Rename API key schemas
- **removed** — Remove without assets filter
- **changed** — Set duration to null when not present
- **security** — Do not allow insecure OAuth requests by default
- **changed** — Move correlationId to X-Correlation-ID response header
- **changed** — Remove redundant error and statusCode fields from error responses
- **removed** — Drop pgvecto.rs support
- **changed** — Express duration in milliseconds
- **changed** — Sanitize error messages to avoid leaking resource details
- **changed** — Implement structured validation error responses
- **added** — Add isOwned filter to albums API
#### Immich v3.0.0-rc.0 — Release Candidate
> \[!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.
We're excited to share our first release candidate (RC) for Immich v3: `v3.0.0-rc.0`. For information about how to use and test the RC, see below.
###### Release notes
Work in progress release notes can be found here:
###### Server
To use this RC version on the server update the `IMMICH_VERSION` in your `.env` file:
```diff
- IMMICH_VERSION=v2
+ IMMICH_VERSION=v3.0.0-rc.0
```
Then pull and restart:
```bash
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 the in release note below, or tap on "Join the beta" from the Google Play Immich page
###### **iOS**
Use the TestFlight link or scan the QR Code
If you run into any issues, please report them on [GitHub](https://github.com/immich-app/immich/issues) so we can address them before the final release. Thank you for helping us test!
---
##### What's Changed
###### 🚨 Breaking Changes
* refactor!: migrate class-validator to zod by @timonrieger in https://github.com/immich-app/immich/pull/26597
* refactor!: remove replace asset by @jrasm91 in https://github.com/immich-app/immich/pull/27022
* refactor!: remove my shared link dto by @jrasm91 in https://github.com/immich-app/immich/pull/27023
* chore!: remove deprecated env variables by @jrasm91 in https://github.com/immich-app/immich/pull/27802
* chore!: remove getRandom api endpoint by @bwees in https://github.com/immich-app/immich/pull/27780
* chore!: remove unused token response param by @jrasm91 in https://github.com/immich-app/immich/pull/27805
* refactor: yeet old timeline by @shenlong-tanwen in https://github.com/immich-app/immich/pull/27666
* chore!: remove old timeline sync endpoints by @jrasm91 in https://github.com/immich-app/immich/pull/27804
* chore!: remove deviceId and deviceAssetId by @danieldietzler in https://github.com/immich-app/immich/pull/27818
* chore!: rename API key schemas by @jrasm91 in https://github.com/immich-app/immich/pull/27828
* chore!: remove without assets by @jrasm91 in https://github.com/immich-app/immich/pull/27835
* fix: oauth issuerUrl validation by @bo0tzz in https://github.com/immich-app/immich/pull/27848
* fix!: do not allow insecure oauth requests by default by @bo0tzz in https://github.com/immich-app/immich/pull/27844
* fix!: set duration to null when not present by @meesfrensel in https://github.com/immich-app/immich/pull/26982
* chore!: remove /api/server/theme endpoint by @jrasm91 in https://github.com/immich-app/immich/pull/27880
* chore!: migrate album owner to album_user by @danieldietzler in https://github.com/immich-app/immich/pull/27467
* refactor!: change number to integer types by @timonrieger in https://github.com/immich-app/immich/pull/27912
* refactor(server)!: move correlationId to X-Correlation-ID response header by @timonrieger in https://github.com/immich-app/immich/pull/28139
* refactor(server)!: remove redundant error and statusCode fields from error responses by @timonrieger in https://github.com/immich-app/immich/pull/28140
* chore(server)!: drop pgvecto.rs support by @mertalev in https://github.com/immich-ap
_[Truncated at 4000 characters — full notes: https://github.com/immich-app/immich/releases/tag/v3.0.0-rc.0]_
### v2.7.5
- Date: 2026-04-13
- Version: v2.7.5
- Original notes: https://github.com/immich-app/immich/releases/tag/v2.7.5
- Permalink: https://whatsnew.fyi/product/immich/releases/v2.7.5
- **fixed** — Add rate limit and deduplication to version check
#### v2.7.5
##### What's Changed
###### 🐛 Bug fixes
* fix(server): add rate limit and deduplication to version check by @zackpollard in https://github.com/immich-app/immich/pull/27747
###### 🌐 Translations
* chore(web): update translations by @weblate in https://github.com/immich-app/immich/pull/27589
**Full Changelog**: https://github.com/immich-app/immich/compare/v2.7.4...v2.7.5