个人笔记，如有转载，请注明出处。

——by realasking

最近登录自己部署在NAS中的immich，老是提示要更新到2.0.1，于是就更新了，中间遇到了些问题，解决之后，在此作个笔记。

  1. 首先down掉immich服务

2.然后要由软件作者提供的最新的docker-compose.yml和.env文件修改

但不要照抄，而是进行修改。比如:

(1) 所有image行，都改成2.0.1的

(2) - ${UPLOAD_LOCATION}:/usr/src/app/upload行不要改

(3) immich-server:节下的：

    ports:
      - 2283:3001

改为：

    ports:
      - 2283:2283

(4) env_file:子节改成自己使用的，如：

    env_file:
      - immich.env

(5) database:节去掉healthcheck:和command:子节，加上shm_size: 128mb

然后先up immich服务，此时会失败。查看log文件，有类似如下提示：

[Api:StorageService] Verifying system mount folder checks, current state: {"mountChecks":{"thumbs":true,"upload":true,"backups":true,"library":true,"profile":true,"encoded-video":true}}
immich_server            | [Nest] 18  - 10/12/2025, 10:54:22 PM   ERROR [Api:StorageService] Failed to read (/usr/src/app/upload/encoded-video/.immich): Error: ENOENT: no such file or directory, open '/usr/src/app/upload/encoded-video/.immich'

但如果直接新建相关的若干.immich文件，还是会报错，需要先逐级更新，再加文件。

  1. 再down掉immich，先更新到v1.132.1，再更新到v1.136.0

(1) 更新到v1.132.1的作法是，在openmediavault的compose文件那儿，打开immich的文件，勾选显示环境文件。将如下内容：

IMMICH_VERSION=release

修改为：

IMMICH_VERSION=v1.132.1

然后先pull，再up。

更新到v1.136.0方法相同。

(2) 更新到v1.132.1后，会发现登录后所有的缩略图和图片都不显示，此时退出来，再更新到v1.136.0。

(3) 更新到v1.136.0之后，会再次报找不到各.immich文件的错误，此时先down掉immich服务，再用docker用户的帐户ssh登录到NAS，执行以下命令：

cd 设置的upload文件夹
for i in library thumbs upload;do touch ${i}/.immich;done
for i in backups encoded-video  profile; do mkdir $i;chmod 755 $i;touch ${i}/.immich;done

然后重新up，再登录，发现immich正常了。

4.更新到v2.0.1(本文成文时的release版)。

(1) down掉immich服务

(2) 将环境文件中如下内容：

IMMICH_VERSION=v1.136.0

修改为：

IMMICH_VERSION=release

(3) 然后pull，再重新up。

immich就更新完毕了。