Skip to main content

Upgrading

Read the release notes

Immich is currently under heavy development, which means you can expect breaking changes and bugs. You should read the release notes prior to updating and take special care when using automated tools like Watchtower.

You can see versions that had breaking changes here.

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:

Upgrade and restart Immich
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:

Clean up unused Docker images
docker image prune