immich-app/immich
1
0
Fork 0
mirror of https://github.com/immich-app/immich.git synced 2026-03-01 11:20:12 +03:00
Code Issues 783 Packages Projects Releases 12 Wiki Activity

iOS backup fails - .immich file missing #7511

New Issue
Closed
opened 2026-02-05 13:06:20 +03:00 by OVERLORD · 4 comments
OVERLORD commented 2026-02-05 13:06:20 +03:00
Owner
Copy Link

Originally created by @electricmessiah on GitHub (Oct 12, 2025).

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

  • Yes

The bug

During a 500 image backup, first backup with a storage template set, the backup failed. I couldn't figure it out, so I searched and came across a post saying to replace the missing .immich file in the upload folder. I did this and everything started working again. What would cause this file to be deleted?

After resuming, many of the thumbnails are now reported as "missing".

The OS that Immich Server is running on

Debian/Docker/Portainer

Version of Immich Server

2.0.1

Version of Immich Mobile App

2.0.1 build.230

Platform with the issue

  • Server
  • Web
  • Mobile

Device make and model

iPhone 16 Pro

Your docker-compose.yml content

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:
      - stack.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:
      - stack.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://docs.immich.app/install/environment-variables

# STORAGE TEMPLATE
# {{y}}/{{MM}}/{{#if album}}{{album}}{{else}}/{{/if}}/{{filename}}

# The location where your uploaded files are stored
# UPLOAD_LOCATION=./library
UPLOAD_LOCATION=/nfs/immich

# The location where your database files are stored. Network shares are not supported for the database
DB_DATA_LOCATION=./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=America/New_York 

# 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=xxxxxx

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

Reproduction steps

  1. Start Upload from iOS
  2. Error occurred after running for a few minutes

...

Relevant log output

ERROR [Microservices:StorageService] Failed to read (/data/upload/.immich): Error: ENOENT: 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 read: "<UPLOAD_LOCATION>/upload/.immich (/data/upload/.immich) - Please see https://docs.immich.app/administration/system-integrity#folder-checks for more information." at StorageService.verifyReadAccess (/usr/src/app/server/dist/services/storage.service.js:129:19)
	
[Nest] 6  - 10/12/2025, 12:41:35 PM     LOG [Microservices:MachineLearningRepository] Machine learning server became unhealthy (http://immich-machine-learning:3003).
Error: could not renew lock for job FacialRecognitionQueueAll

Additional information

No response

Originally created by @electricmessiah on GitHub (Oct 12, 2025). ### I have searched the existing issues, both open and closed, to make sure this is not a duplicate report. - [x] Yes ### The bug During a 500 image backup, first backup with a storage template set, the backup failed. I couldn't figure it out, so I searched and came across a post saying to replace the missing .immich file in the upload folder. I did this and everything started working again. What would cause this file to be deleted? After resuming, many of the thumbnails are now reported as "missing". ### The OS that Immich Server is running on Debian/Docker/Portainer ### Version of Immich Server 2.0.1 ### Version of Immich Mobile App 2.0.1 build.230 ### Platform with the issue - [x] Server - [ ] Web - [x] Mobile ### Device make and model iPhone 16 Pro ### Your docker-compose.yml content ```YAML 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: - stack.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: - stack.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 ```Shell # You can find documentation for all the supported env variables at https://docs.immich.app/install/environment-variables # STORAGE TEMPLATE # {{y}}/{{MM}}/{{#if album}}{{album}}{{else}}/{{/if}}/{{filename}} # The location where your uploaded files are stored # UPLOAD_LOCATION=./library UPLOAD_LOCATION=/nfs/immich # The location where your database files are stored. Network shares are not supported for the database DB_DATA_LOCATION=./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=America/New_York # 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=xxxxxx # The values below this line do not need to be changed ################################################################################### DB_USERNAME=postgres DB_DATABASE_NAME=immich ``` ### Reproduction steps 1. Start Upload from iOS 2. Error occurred after running for a few minutes 3. ... ### Relevant log output ```shell ERROR [Microservices:StorageService] Failed to read (/data/upload/.immich): Error: ENOENT: 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 read: "<UPLOAD_LOCATION>/upload/.immich (/data/upload/.immich) - Please see https://docs.immich.app/administration/system-integrity#folder-checks for more information." at StorageService.verifyReadAccess (/usr/src/app/server/dist/services/storage.service.js:129:19) [Nest] 6 - 10/12/2025, 12:41:35 PM LOG [Microservices:MachineLearningRepository] Machine learning server became unhealthy (http://immich-machine-learning:3003). Error: could not renew lock for job FacialRecognitionQueueAll ``` ### Additional information _No response_
OVERLORD commented 2026-02-05 13:06:22 +03:00
Author
Owner
Copy Link

@mmomjian commented on GitHub (Oct 12, 2025):

It's likely that your NFS mount got unmounted or was not mounted when docker started.

FYI you should never need to manually make that file except in some very specific circumstances. By doing so you circumvented the safety checks and your library is probably in an inconsistent state.

@mmomjian commented on GitHub (Oct 12, 2025): It's likely that your NFS mount got unmounted or was not mounted when docker started. FYI you should never need to manually make that file except in some very specific circumstances. By doing so you circumvented the safety checks and your library is probably in an inconsistent state.
OVERLORD commented 2026-02-05 13:06:23 +03:00
Author
Owner
Copy Link

@electricmessiah commented on GitHub (Oct 12, 2025):

Interesting.. the mount is up and running and never got unmounted from what I see. The only folder with the missing .immich file was "uploads" as it was present in all the others.

@electricmessiah commented on GitHub (Oct 12, 2025): Interesting.. the mount is up and running and never got unmounted from what I see. The only folder with the missing .immich file was "uploads" as it was present in all the others.
OVERLORD commented 2026-02-05 13:06:24 +03:00
Author
Owner
Copy Link

@mmomjian commented on GitHub (Oct 12, 2025):

Got it. Immich would not have deleted that file, so you should explore other issues with your storage and/or network mount.

@mmomjian commented on GitHub (Oct 12, 2025): Got it. Immich would not have deleted that file, so you should explore other issues with your storage and/or network mount.
OVERLORD commented 2026-02-05 13:06:24 +03:00
Author
Owner
Copy Link

@Stooovie commented on GitHub (Oct 13, 2025):

Same issue. Mount is mounted and writable by root, path is correct, yet I'm getting

ERROR [Microservices:StorageService] Failed to read (/data/library/.immich): Error: ENOENT: no such file or directory, open '/data/library/.immich'
microservices worker error: Error: Failed to read: "<UPLOAD_LOCATION>/library/.immich (/data/library/.immich)

I had no such issues in my previous LXC and VM/Docker installs.

@Stooovie commented on GitHub (Oct 13, 2025): Same issue. Mount is mounted and writable by root, path is correct, yet I'm getting ``` ERROR [Microservices:StorageService] Failed to read (/data/library/.immich): Error: ENOENT: no such file or directory, open '/data/library/.immich' microservices worker error: Error: Failed to read: "<UPLOAD_LOCATION>/library/.immich (/data/library/.immich) ``` I had no such issues in my previous LXC and VM/Docker installs.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
accessibility
changelog:enhancement
changelog:security
changelog:skip
changelog:translation
cli
date-time
dependencies
documentation
external-library
format
good first issue
mobile-beta
mobile-beta
mobile-beta
needs-answer
nice to have
pull-request
Mirrored from GitHub Pull Request
 sharing
tech-debt
📱mobile
🖥️web
🗄️server
🧠machine-learning
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
OVERLORD
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: immich-app/immich#7511
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?