Immich 2.1.0 → 3.2.4

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

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

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

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.

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

For those who are still using the old timeline, please switch to the new timeline to avoid interruption, as the old timeline will be removed in the next release.

ps: The old timeline has an exclamation icon next to the logo.

Known limitations

• The machine learning service on amd64 currently requires the >= x86-64-v2 microarchitecture. This will be patched in an upcoming patch release for backward compatibility with very old processors (before ~2010), but it will become a minimum requirement in 3.0. arm64 is not affected by this change.

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

For assets imported prior to v3, you will also need to re-run Metadata Extraction in the job panel for them to be re-processed.

• 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-app/immich/pull/28159
• chore!: duration in milliseconds by @mertalev in https://github.com/immich-app/immich/pull/28003
• refactor(server)!: sanitize error messages to avoid leaking resource details by @timonrieger in https://github.com/immich-app/immich/pull/28154
• refactor(server)!: structured validation error responses by @timonrieger in https://github.com/immich-app/immich/pull/28204
• feat(server)!: add isOwned filter to albums API by @timonrieger in https://github.com/immich-app/immich/pull/28213
• chore(ml)!: require numpy 2.4 by @mertalev in https://github.com/immich-app/immich/pull/28158
• fix(deps): update dependency nestjs-otel to v8 by @renovate[bot] in https://github.com/immich-app/immich/pull/27863
• chore(ml)!: remove deprecated envs by @mertalev in https://github.com/immich-app/immich/pull/28326
• chore(server)!: remove libopus enum by @mertalev in https://github.com/immich-app/immich/pull/28325
• refactor!: remove asset faces from AssetResponseDto by @bwees in https://github.com/immich-app/immich/pull/27779
• refactor(server)!: drop empty string to null conversion by @timonrieger in https://github.com/immich-app/immich/pull/28808
• refactor(server)!: remove changeExpiryTime by @timonrieger in https://github.com/immich-app/immich/pull/28816
• refactor!: disallow star rating < 1 by @meesfrensel in https://github.com/immich-app/immich/pull/27896
• fix!: search endpoints visibility can be omitted by @danieldietzler in https://github.com/immich-app/immich/pull/29385

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.

• chore(mobile): drop support for iOS 14 by @agg23 in https://github.com/immich-app/immich/pull/29780