What Immich meant by a stable release
The project’s first stable tag set an expectation around compatibility. Its release announcement is worth reading before planning upgrades.

In this article
From the release archive
On October 1, 2025, Immich announced v2.0.0 as its stable release. The maintainers described a shift toward compatibility and simpler updates after addressing accumulated technical debt. The announcement also marked the removal of the warning banner on the project website.
What to take into an upgrade
Treat stability as a statement of project priorities. For your particular installation, read the changes between the precise running and target versions, identify database or configuration changes, and check the backup procedure for that version.
Make the next check easy
Keep the installed version, media paths and last successful restore date with your deployment notes. A short record gives the next operator something more actionable than the fact that the system ran successfully yesterday.
What stability changes for an operator
A stable label is a useful milestone, but each release still comes with instructions. On a family photo server, identify what can be replaced and what has to be restored. A container image can be pulled again. A catalog with hand-built albums or sharing state may be costly to reconstruct. Review specific upgrade notes for your deployed version and verify your recovery materials before moving across a major boundary.
Keep a record of the last app version paired with a known-good database backup. On a temporary instance, open a sample album and download a known original before declaring the restore usable. If an upgrade requires a schema change, rehearse recovering the older app and its matching backup together.
Read the date in context
The original stability milestone helps explain how the project reached its current release cadence. For an upgrade today, judge the exact target build by its current release notes and your own test. Preserve the older announcement as a date in the project's history.
Primary sources
Immich project blogRead next Immich fixes two quiet failures in library monitoring