Immich/docs/src/pages/errors.md

Errors

TypeORM Upgrade

The upgrade to Immich v2.x.x has a required upgrade path to v1.132.0+. This means it is required to start up the application at least once on version 1.132.0 (or later). Doing so will complete database schema upgrades that are required for v2.0.0. After Immich has successfully booted on this version, shut the system down and try the v2.x.x upgrade again.

Inconsistent Media Location

:::caution This error is related to the location of media files inside the container. Never move files on the host system when you run into this error message. :::

Immich automatically tries to detect where your Immich data is located. On start up, it compares the detected media location with the file paths in the database and throws an Inconsistent Media Location error when they do not match.

To fix this issue, verify that the IMMICH_MEDIA_LOCATION environment variable and UPLOAD_LOCATION volume mount are in sync with the database paths.

If you would like to migrate from one media location to another, simply successfully start Immich on v1.136.0 or later, then do the following steps:

1. Stop Immich
2. Update IMMICH_MEDIA_LOCATION to the new location
3. Update the right-hand side of the UPLOAD_LOCATION volume mount to the new location
4. Start up Immich

After version 1.136.0, Immich can detect when a media location has moved and will automatically update the database paths to keep them in sync.