How to Update Immich Safely
Follow Immich's release notes, major-version policy, database migration warnings, and rollback limits before upgrading.
Direct answer
Read the release notes, update IMMICH_VERSION, then run docker compose pull && docker compose up -d from the directory containing your compose file. Back up the database before migrations and do not plan on downgrading.
Current versions
Research checked Immich stable v3.1.0 and prerelease v3.2.0-rc.3 on 2026-09-08. A release candidate is not the same as the stable major-version tag.
Upgrade rules
Immich recommends upgrading mobile clients before the server. The server expects the matching major version. Downgrading to an earlier version is unsupported. Read breaking changes before pulling images.
VectorChord migration
If your Compose database image still uses the older pgvecto.rs setup, the official migration guide requires a database backup first. After switching to VectorChord, do not downgrade below v1.133.0.
Community evidence
A Synology upgrade helper in Discussion #25771 is community-maintained, not an Immich tool. Its author reports dry-run and backup features, while a user reported a script error. Do not treat it as a supported update mechanism.