Skip to content

Releases: immich-app/immich

v3.0.2

Choose a tag to compare

@immich-push-o-matic immich-push-o-matic released this 09 Jul 18:03

v3.0.2

This patch release addresses various bugs from v3 release and adds an additional filter to workflows

What's Changed

🌟 Enhancements

🐛 Bug fixes

📚 Documentation

🌐 Translations

New Contributors

Full Changelog: v3.0.1...v3.0.2

v3.0.1

Choose a tag to compare

@immich-push-o-matic immich-push-o-matic released this 02 Jul 21:32

v3.0.1

  • Fixes a bug that causes albums don't show up in the mobile app

What's Changed

🚀 Features

🐛 Bug fixes

🌐 Translations

Full Changelog: v3.0.0...v3.0.1

v3.0.0

Choose a tag to compare

@immich-push-o-matic immich-push-o-matic released this 02 Jul 13:58

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. 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:

- IMMICH_VERSION=v2
+ IMMICH_VERSION=v3

Then run the usual update commands:

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).

New release channel option in version check settings

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
immich-store (1)

Check it out now at https://immich.store!

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

image

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
  • Editing live photos
  • Editing local assets

We have plans to bring some of these capabilities back in future releases.

Workflows (preview)

The first preview of Workflows is here! Workflows let you automate actions in your library by chaining triggers, filters, and actions together with a drag-and-drop builder. This is the foundation for many exciting automations to come, and we'd love your feedback as we continue building on it.

You can access the feature from Utilities > Workflows on the web.

Workflows link on the utilities page

From there, you can either create a new blank workflow or browse the premade templates to get a basic understanding of how workflows can be used.

image

Workflows editor

Workflow editor with an example workflow

In the workflows editor, you can switch between the Visual or JSON editor. The visual editor is nice for building out the workflow; the JSON editor is nice for sharing and receiving workflow content from others.

In each workflow, there is a trigger and a sequence of steps.

  • Trigger: this is the entry point of each workflow; when the trigger occurs, the steps are evaluated.
  • Steps: they include Filters (conditions) and Actions (effects); they can be combined to produce the desired effect of the use case you aim for.

List of available workflow steps

Sharing a workflow

You can share the workflow you made with others in two ways: text and JSON. Text is nice for sharing on a forum or for show-and-tell content. JSON is nice for others to make an exact copy of your workflow's configuration.

You can copy the text in the workflows summary panel on the lower right of the screen

workflow summary in text

You can share the JSON content from the copy workflows button in the app bar, switch to the JSON editor, or use the Show schema button in the context menu in the workflows list

JSON editor Show workflow schema

Note

Please use this discussion thread to propose new ideas of triggers and actions. We are looking for extensive feedback and suggestions from you all.

Background backup improvements

Background backup on Android is now significantly more reliable. Previously, the background backup on Android was limited to newly taken photos. Now, the app uses a new periodic task scheduler, which allows you to upload your entire library in the background, and it plays nicer with Android's background execution limits, properly cleans up tasks, and warns you when battery optimization and notification settings might interfere with backups.

On iOS, the background refresh task now runs its sync and upload work in parallel, so uploads actually start within the short time window iOS allows.

Enable backup option on mobile

Recently added page

A new "Recently Added" page on the web and mobile lets you browse your library sorted by when assets were added to Immich, rather than when they were taken. This makes it easier to find what's new when browsing a new batch of imports. You can find the new page in the "Explore" tab on the web and in the "Search" tab on mobile.

Recently added

Integrity checks

The maintenance page has gotten a new addition: integrity reports! Immich will scan its directories on your file system, and compare it to what it has stored in its database. If there are deviations, they will be surfaced as

  • untracked, if there is a file in Immich's directories that Immich does not know of
  • missing, if Immich references a file in its database that does not exist in that place (anymore)
  • a checksum mismatch, if the checksum of the file on disk does not match the checksum Immich has stored for that file. Typically, this would happen through file corruption but could also be the result of a bad rename.
Integrity report on the maintenance page showing a count of untracked and missing files, as well as checksum mismatches.

You can configure when and how long the job runs each night.

image

Slideshow (mobile)

The slideshow experience comes to mobile! You can now sit back and let your photos and videos play across the screen, just like on the web.

Slideshow view on mobile

HLS and Real-Time Video transcoding (preview)

Immich can now transcode videos on-the-fly without needing to generate offline transcodes. This has been a long-requested feature with many benefits:

  • Quality switching (both manual and automati...
Read more

v3.0.0-rc.3

v3.0.0-rc.3 Pre-release
Pre-release

Choose a tag to compare

@immich-push-o-matic immich-push-o-matic released this 26 Jun 21:52

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:

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

image

iOS

The iOS app is available via Testflight: https://testflight.apple.com/join/JTSTucBd

image

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

🐛 Bug fixes

📚 Documentation

🌐 Translations

New Contributors

Full Changelog: v3.0.0-rc.2...v3.0.0-rc.3

v3.0.0-rc.2

v3.0.0-rc.2 Pre-release
Pre-release

Choose a tag to compare

@danieldietzler danieldietzler released this 19 Jun 16:41

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:

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

image

iOS

We are currently having issues with the iOS release. Expect a new version on TestFlight to land early next week at the latest: https://testflight.apple.com/join/JTSTucBd

image

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!

What's Changed

🐛 Bug fixes

📚 Documentation

  • docs(mobile-app): add Play App Signing certificate hash by @tlvince in #29168
  • docs(mobile): point users towards shared setup docs by @agg23 in #29078

🌐 Translations

New Contributors

Full Changelog: v3.0.0-rc.1...v3.0.0-rc.2

v3.0.0-rc.1

v3.0.0-rc.1 Pre-release
Pre-release

Choose a tag to compare

@immich-push-o-matic immich-push-o-matic released this 17 Jun 14:52

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:

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

image

iOS

Use the TestFlight link or scan the QR Code https://testflight.apple.com/join/JTSTucBd

image

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!

What's Changed

🌟 Enhancements

🐛 Bug fixes

📚 Documentation

  • docs(server): clarify AssetBulkUploadCheckItem.id is a correlation token by @timonrieger in #29141

🌐 Translations

New Contributors

Full Changelog: v3.0.0-rc.0...v3.0.0-rc.1

v3.0.0-rc.0

v3.0.0-rc.0 Pre-release
Pre-release

Choose a tag to compare

@immich-push-o-matic immich-push-o-matic released this 15 Jun 14:38

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:

- IMMICH_VERSION=v2
+ IMMICH_VERSION=v3.0.0-rc.0

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 the in release note below, or tap on "Join the beta" from the Google Play Immich page

image

iOS

Use the TestFlight link or scan the QR Code https://testflight.apple.com/join/JTSTucBd

image

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!


What's Changed

🚨 Breaking Changes

🫥 Deprecated Changes

🔒 Security

  • fix: run profile picture through thumbnail pipeline by @bo0tzz in #27890

🚀 Features

🌟 Enhancements

Read more

v2.7.5

Choose a tag to compare

@immich-push-o-matic immich-push-o-matic released this 13 Apr 14:53

v2.7.5

What's Changed

🐛 Bug fixes

  • fix(server): add rate limit and deduplication to version check by @zackpollard in #27747

🌐 Translations

Full Changelog: v2.7.4...v2.7.5

v2.7.4

Choose a tag to compare

@immich-push-o-matic immich-push-o-matic released this 10 Apr 17:06

v2.7.4

This release addresses some issues with image rendering on the mobile app

What's Changed

🐛 Bug fixes

Full Changelog: v2.7.3...v2.7.4

v2.7.3

Choose a tag to compare

@immich-push-o-matic immich-push-o-matic released this 09 Apr 18:12

v2.7.3

What's Changed

🐛 Bug fixes

  • fix(server): avoid false restore failures on large database imports by @ErasmusAndre in #27420
  • fix(mobile): improve image load cancellation handling by @LeLunZ in #27624
  • fix(server): people search not showing for 3 or less characters by @zackpollard in #27629
  • fix(web): don't cache empty search results for people search by @zackpollard in #27632
  • fix(mobile): get provider refs before async gaps in backup page by @LeLunZ in #27597
  • fix: ssr open graph tags by @jrasm91 in #27639

📚 Documentation

New Contributors

Full Changelog: v2.7.2...v2.7.3