Immich v2.0.1 issues with server integrity

[zhemant]

I have searched the existing issues, both open and closed, to make sure this is not a duplicate report.

• Yes

The bug

I upgraded to v2.0.1 from v1.139.2, the immich server was stuck with creating/reading file from upload directory.

The OS that Immich Server is running on

ubuntu 22.04

Version of Immich Server

v2.0.1

Version of Immich Mobile App

v2.0.0

Platform with the issue

• Server
• Web
• Mobile

Device make and model

No response

Your docker-compose.yml content

#
# WARNING: To install Immich, follow our guide: https://docs.immich.app/install/docker-compose
#
# Make sure to use the docker-compose.yml of the current release:
#
# https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
#
# The compose file on main may not be compatible with the latest release.

name: immich

services:
  immich-server:
    container_name: immich_server
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    # extends:
    #   file: hwaccel.transcoding.yml
    #   service: cpu # set to one of [nvenc, quicksync, rkmpp, vaapi, vaapi-wsl] for accelerated transcoding
    volumes:
      # Do not edit the next line. If you want to change the media storage location on your system, edit the value of UPLOAD_LOCATION in the .env file
      - ${UPLOAD_LOCATION}:/data
      - /etc/localtime:/etc/localtime:ro
    env_file:
      - .env
    ports:
      - '2283:2283'
    depends_on:
      - redis
      - database
    restart: always
    healthcheck:
      disable: false

  # immich-machine-learning:
  #   container_name: immich_machine_learning
  #   # For hardware acceleration, add one of -[armnn, cuda, rocm, openvino, rknn] to the image tag.
  #   # Example tag: ${IMMICH_VERSION:-release}-cuda
  #   image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}
  #   # extends: # uncomment this section for hardware acceleration - see https://docs.immich.app/features/ml-hardware-acceleration
  #   #   file: hwaccel.ml.yml
  #   #   service: cpu # set to one of [armnn, cuda, rocm, openvino, openvino-wsl, rknn] for accelerated inference - use the `-wsl` version for WSL2 where applicable
  #   volumes:
  #     - model-cache:/cache
  #   env_file:
  #     - .env
  #   restart: always
  #   healthcheck:
  #     disable: false

  redis:
    container_name: immich_redis
    image: docker.io/valkey/valkey:8-bookworm@sha256:fea8b3e67b15729d4bb70589eb03367bab9ad1ee89c876f54327fc7c6e618571
    healthcheck:
      test: redis-cli ping || exit 1
    restart: always

  database:
    container_name: immich_postgres
    image: ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0@sha256:41eacbe83eca995561fe43814fd4891e16e39632806253848efaf04d3c8a8b84
    environment:
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_USER: ${DB_USERNAME}
      POSTGRES_DB: ${DB_DATABASE_NAME}
      POSTGRES_INITDB_ARGS: '--data-checksums'
      # Uncomment the DB_STORAGE_TYPE: 'HDD' var if your database isn't stored on SSDs
      # DB_STORAGE_TYPE: 'HDD'
    volumes:
      # Do not edit the next line. If you want to change the database storage location on your system, edit the value of DB_DATA_LOCATION in the .env file
      - ${DB_DATA_LOCATION}:/var/lib/postgresql/data
    shm_size: 128mb
    restart: always

volumes:
  model-cache:

Your .env content

# You can find documentation for all the supported env variables at https://immich.app/docs/install/environment-variables

# The location where your uploaded files are stored
UPLOAD_LOCATION=/mnt/drivex/immich/data

# The location where your database files are stored. Network shares are not supported for the database
DB_DATA_LOCATION=/mnt/drivex/immich/postgres

# To set a timezone, uncomment the next line and change Etc/UTC to a TZ identifier from this list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List
TZ=Europe/Berlin

# The Immich version to use. You can pin this to a specific version like "v1.71.0"
IMMICH_VERSION=release

# Connection secret for postgres. You should change it to a random password
# Please use only the characters `A-Za-z0-9`, without special characters or spaces
DB_PASSWORD=postgres

# The values below this line do not need to be changed
###################################################################################
DB_USERNAME=postgres
DB_DATABASE_NAME=immich

Reproduction steps

1. Deploy v1.139.2
2. Upgrade to v2.0.1

...

Relevant log output

Initializing Immich v2.0.1                                                                                               
Detected CPU Cores: 4                                                                                                    
Starting api worker                                                                                                      
Starting microservices worker                                                                                            
[Nest] 6  - 10/04/2025, 5:20:48 PM     LOG [Microservices:EventRepository] Initialized websocket server                  
[Nest] 6  - 10/04/2025, 5:20:48 PM     LOG [Microservices:DatabaseRepository] targetLists=1, current=1 for clip_index of 
0 rows                                                                                                                   
[Nest] 6  - 10/04/2025, 5:20:48 PM     LOG [Microservices:DatabaseRepository] targetLists=1, current=1 for face_index of 
0 rows                                                                                                                   
[Nest] 6  - 10/04/2025, 5:20:48 PM     LOG [Microservices:StorageService] Verifying system mount folder checks, current s
tate: {"mountChecks":{"thumbs":true,"upload":true,"backups":true,"library":true,"profile":true,"encoded-video":true}} 
[Nest] 6  - 10/04/2025, 5:20:48 PM   ERROR [Microservices:StorageService] Failed to read (/data/upload/.immich): Error: E
NOENT: no such file or directory, open '/data/upload/.immich'                                                            
microservices worker error: Error: Failed to read: "<UPLOAD_LOCATION>/upload/.immich (/data/upload/.immich) - Please see 
https://docs.immich.app/administration/system-integrity#folder-checks for more information.", stack: Error: Failed to rea
d: "<UPLOAD_LOCATION>/upload/.immich (/data/upload/.immich) - Please see https://docs.immich.app/administration/system-in
tegrity#folder-checks for more information."                                                                                 at StorageService.verifyReadAccess (/usr/src/app/server/dist/services/storage.service.js:129:19)
    at async /usr/src/app/server/dist/services/storage.service.js:56:21                                                  
    at async /usr/src/app/server/dist/repositories/database.repository.js:379:27                                         
    at async /usr/src/app/server/node_modules/.pnpm/kysely@0.28.2/node_modules/kysely/dist/cjs/kysely.js:535:20          
    at async DefaultConnectionProvider.provideConnection (/usr/src/app/server/node_modules/.pnpm/kysely@0.28.2/node_modul
es/kysely/dist/cjs/driver/default-connection-provider.js:12:20)                                                          
    at async /usr/src/app/server/dist/repositories/database.repository.js:376:13                                         
microservices worker exited with code 1                                                                                  
Killing api process

Additional information

I could see .immich file created in other folders. However there was only issues with upload directory. I tried creating the file manually in upload directory which fixed the issue.

[aviv926]

I had the exact same problem after an update as well. The solution was to do a 'docker system prune -a' and then re-pull the image and that solved the problem.