From 6f45521610783ddf744db306e6dac5e9f59f035a Mon Sep 17 00:00:00 2001 From: Matthew Momjian <50788000+mmomjian@users.noreply.github.com> Date: Mon, 6 Jul 2026 23:07:31 +0400 Subject: [PATCH] fix(docs): clarify version policy (#29654) * version policy * Update docs/docs/install/upgrading.md Co-authored-by: Daniel Dietzler <36593685+danieldietzler@users.noreply.github.com> --------- Co-authored-by: Daniel Dietzler <36593685+danieldietzler@users.noreply.github.com> --- docs/docs/install/upgrading.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/docs/install/upgrading.md b/docs/docs/install/upgrading.md index 8fc9113e6d..f302719c76 100644 --- a/docs/docs/install/upgrading.md +++ b/docs/docs/install/upgrading.md @@ -28,11 +28,15 @@ docker image prune ## 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 `:v3`. +Immich follows [semantic versioning][semver], which tags releases in the format `..`. +We intend for breaking changes, including those to the API or deployment, 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 `:v3`. These metatags do not follow release candidates. -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. +The mobile app is typically compatible with the current and prior major version. However, the server is only compatible with the matching major version. +Thus, we recommend upgrading all mobile clients before upgrading the server to ensure compatibility. + +We do not backport patches to earlier versions. We encourage all users to run the most recent stable release of Immich. +Downgrading to an earlier version, even within the same minor version, is not supported. [semver]: https://semver.org/