High performance self-hosted photo and video management solution.
TypeScript backup-toolfluttergoogle-photosgoogle-photos-alternativejavascriptmobile-appnestjsnodejsphoto-galleryphotosphotos-managementself-hostedsveltesveltekittypescriptvideos
fix(docs): clarify version policy (#29654)
Matthew Momjian6f4552161078
diff --git a/docs/docs/install/upgrading.md b/docs/docs/install/upgrading.mdindex 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 `<major>.<minor>.<patch>`. 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 `<major>.<minor>.<patch>`.+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/