【笔记】docker-compose安装的immich从v1.112.1升级到v2.0.1的注意事项
个人笔记，如有转载，请注明出处。
——by realasking
最近登录自己部署在NAS中的immich，老是提示要更新到2.0.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文件，还是会报错，需要先逐级更新，再加文件。
- 再
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就更新完毕了。