Upgrading
You can see versions that had breaking changes here.
Immich only supports upgrading to the most recent stable release, and the server and mobile app have to be upgraded in a particular order — see Versioning before a major-version upgrade.
When a new version of Immich is released, you should read the release notes and account for any breaking changes noted (as mentioned above).
If you use IMMICH_VERSION in your .env file, it will need to be updated to the latest or desired version.
After that, the application can be upgraded and restarted with the following commands, run in the directory with the docker-compose.yml file:
docker compose pull && docker compose up -d
To clean up disk space, the old version's obsolete container images can be deleted with the following command:
docker image prune
Migrating to VectorChord
Instances still using the deprecated pgvecto.rs database extension have to move to VectorChord. See Migrate to VectorChord.