From 880f2bc2c5e0b9510990d194f71b08fe5f0efa7d Mon Sep 17 00:00:00 2001 From: Sergey Katsubo Date: Tue, 16 Sep 2025 06:29:12 +0300 Subject: [PATCH] chore(docs): TypeORM error: force recommend v1.132.3 and avoid v1.136 (#22033) * TypeORM error: force recommend v1.132.3 and avoid v1.136 * Add extra line break for clarity * Fix formatting error: remove an asterisk * chore: use admonitions --------- Co-authored-by: Jason Rasmussen --- docs/src/pages/errors.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/src/pages/errors.md b/docs/src/pages/errors.md index 5f73162a61..fed72f21c7 100644 --- a/docs/src/pages/errors.md +++ b/docs/src/pages/errors.md @@ -2,7 +2,17 @@ ## TypeORM Upgrade -In order to update to Immich to `v1.137.0` (or above), the application must be started at least once on a version in the range between `1.132.0` and `1.136.0`. Doing so will complete database schema upgrades that are required for `v1.137.0` (and above). After Immich has successfully updated to a version in this range, you can now attempt to update to v1.137.0 (or above). We recommend users upgrade to `1.132.0` since it does not have any other breaking changes. +If you encountered "Migrations failed: Error: Invalid upgrade path" then perform an intermediate upgrade to `v1.132.3` first. + +:::tip +We recommend users upgrade to `v1.132.3` since it does not have any breaking changes or bugs on this upgrade path. +::: + +In order to update to Immich `v1.137.0` or above, the application must be started at least once on a version in the range between `1.132.0` and `1.136.0`. Doing so will complete database schema upgrades that are required for `v1.137.0` (and above). After Immich has successfully updated to a version in this range, you can now attempt to update to `v1.137.0` (or above). + +:::caution +Avoid `v1.136.0` if upgrading from `v1.131.0` (or earlier) due to a bug blocking this upgrade in some installations. +::: ## Inconsistent Media Location