immich version history
10 releases tracked, newest first.
v3.0.1
Jul 2, 2026# 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
4 downloads
v3.0.0
Jul 2, 2026# 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
4 downloads
v3.0.0-rc.3
Pre-releaseJun 26, 2026> \[!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:
<https://pr-558.dev.immich.app/blog/v3.0.0-release>
### 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
<img width="300" alt="image" src="https://github.com/user-attachments/assets/550d5059-bd0b-4a67-94f2-44231c704b90" />
#### **iOS**
The iOS app is available via Testflig
4 downloads
v3.0.0-rc.2
Pre-releaseJun 19, 2026> \[!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:
<https://pr-558.dev.immich.app/blog/v3.0.0-release>
### 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
<img width="300" alt="image" src="https://github.com/user-attachments/assets/550d5059-bd0b-4a67-94f2-44231c704b90" />
#### **iOS**
We are currently having issues with
4 downloads
v3.0.0-rc.1
Pre-releaseJun 17, 2026# 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:
<https://pr-558.dev.immich.app/blog/v3.0.0-release>
### 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
<img width="300" alt="image" src="https://github.c
4 downloads
v3.0.0-rc.0
Pre-releaseJun 15, 2026# 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:
<https://pr-558.dev.immich.app/blog/v3.0.0-release>
### 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
<img width="300" alt="image" src="https://github.com/user-attachments/assets/550d5059-bd0b-4a67-94f2-44231c70
4 downloads
v2.7.5
Apr 13, 2026# 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
4 downloads
v2.7.4
Apr 10, 2026# v2.7.4
This release addresses some issues with image rendering on the mobile app
## What's Changed
### 🐛 Bug fixes
* refactor(mobile): cleanup iOS image loading pipeline by @LeLunZ in https://github.com/immich-app/immich/pull/27672
* fix(server): hide original filename when not showing metadata by @meesfrensel in https://github.com/immich-app/immich/pull/27581
* fix(mobile): fix Flutter cache eviction on thumbnails by @LeLunZ in https://github.com/immich-app/immich/pull/27663
* chore: pump cronet version by @shenlong-tanwen in https://github.com/immich-app/immich/pull/27685
**Full Changelog**: https://github.com/immich-app/immich/compare/v2.7.3...v2.7.4
4 downloads
v2.7.3
Apr 9, 2026# v2.7.3
## What's Changed
### 🐛 Bug fixes
* fix(server): avoid false restore failures on large database imports by @ErasmusAndre in https://github.com/immich-app/immich/pull/27420
* fix(mobile): improve image load cancellation handling by @LeLunZ in https://github.com/immich-app/immich/pull/27624
* fix(server): people search not showing for 3 or less characters by @zackpollard in https://github.com/immich-app/immich/pull/27629
* fix(web): don't cache empty search results for people search by @zackpollard in https://github.com/immich-app/immich/pull/27632
* fix(mobile): get provider refs before async gaps in backup page by @LeLunZ in https://github.com/immich-app/immich/pull/27597
* fix: ssr open graph tags by @jrasm91 in https://github.com/immich-app/immich/pull/27639
### 📚 Documentation
* fix(docs): updated docker deprecation link by @mmomjian in https://github.com/immich-app/immich/pull/27633
## New Contributors
* @fluffy made their first contribution in https://github.com/immich-app/immich/pull/27606
* @ErasmusAndre made their first contribution in https://github.com/immich-app/immich/pull/27420
**Full Changelog**: https://github.com/immich-app/immich/com
4 downloads
v2.7.2
Apr 7, 2026You knew it was coming :sweat_smile:
This release addresses the following issues:
- Fix an issue with the default helmet.json file
- Fix an issue with ML containers not working on some older CPUs
- Fix an issue with importing external libraries
<!-- Release notes generated using configuration in .github/release.yml at v2.7.2 -->
## What's Changed
### 🐛 Bug fixes
* fix: csp quotes by @bo0tzz in https://github.com/immich-app/immich/pull/27592
* fix(ml): downgrade numpy by @mertalev in https://github.com/immich-app/immich/pull/27591
* fix(server): library import batch size by @mertalev in https://github.com/immich-app/immich/pull/27595
**Full Changelog**: https://github.com/immich-app/immich/compare/v2.7.0...v2.7.2
4 downloads