From 84e30abe5d97863cbfcb72f3ffd62b2f6ed7f728 Mon Sep 17 00:00:00 2001 From: Matthew Momjian <50788000+mmomjian@users.noreply.github.com> Date: Fri, 6 Feb 2026 20:31:57 -0500 Subject: [PATCH] feat(docs): version policy (#25979) version policy --- docs/docs/install/upgrading.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/docs/install/upgrading.md b/docs/docs/install/upgrading.md index bf788cb680..12e5c9c342 100644 --- a/docs/docs/install/upgrading.md +++ b/docs/docs/install/upgrading.md @@ -26,6 +26,16 @@ docker image prune [breaking]: https://github.com/immich-app/immich/discussions?discussions_q=label%3Achangelog%3Abreaking-change+sort%3Adate_created [releases]: https://github.com/immich-app/immich/releases +## Versioning Policy + +Immich follows [semantic versioning][semver], which tags releases in the format `..`. We intend for breaking changes to be limited to major version releases. +You can configure your Docker image to point to the current major version by using a metatag, such as `:v2`. + +Currently, we have no plans to backport patches to earlier versions. We encourage all users to run the most recent release of Immich. +Switching back to an earlier version, even within the same minor release tag, is not supported. + +[semver]: https://semver.org/ + ## Migrating to VectorChord :::info