immich-app/immich
1
0
Fork 0
mirror of https://github.com/immich-app/immich.git synced 2026-07-25 14:00:45 +03:00
Code Issues 783 Packages Projects Releases 22 Wiki Activity

Couldn't install latest version (1.116.2) of Immich on Raspberry PI 5 (debian bookworm) #4435

New Issue
Closed
opened 2026-02-05 10:22:54 +03:00 by OVERLORD · 4 comments
OVERLORD commented 2026-02-05 10:22:54 +03:00
Owner
Copy Link

Originally created by @virtualestate on GitHub (Sep 29, 2024).

The bug

On a fresh install of the latest version (1.116.2) of Immich on a Raspberry Pi 5 running Debian Bookworm, upon docker compose up for the first time, immich_server gets stuck in a restart loop outputting the following message:

immich_server            | /usr/src/app/node_modules/sharp/lib/sharp.js:113
immich_server            |   throw new Error(help.join('\n'));
immich_server            |   ^
immich_server            |
immich_server            | Error: Could not load the "sharp" module using the linux-arm64 runtime
immich_server            | ERR_DLOPEN_FAILED: libvips-cpp.so.42: cannot open shared object file: No such file or directory
immich_server            | Possible solutions:
immich_server            | - Ensure optional dependencies can be installed:
immich_server            |     npm install --include=optional sharp
immich_server            | - Ensure your package manager supports multi-platform installation:
immich_server            |     See https://sharp.pixelplumbing.com/install#cross-platform
immich_server            | - Add platform-specific dependencies:
immich_server            |     npm install --os=linux --cpu=arm64 sharp
immich_server            | - Consult the installation documentation:
immich_server            |     See https://sharp.pixelplumbing.com/install
immich_server            |     at Object.<anonymous> (/usr/src/app/node_modules/sharp/lib/sharp.js:113:9)
immich_server            |     at Module._compile (node:internal/modules/cjs/loader:1469:14)
...

Error persists after restarting containers, docker and the physical device.

Same error appears in 1.116.1 and 1.116.0.

WORKS AS EXPECTED IN 1.115.0

The OS that Immich Server is running on

Debian 12 (Bookworm)

Version of Immich Server

1.116.2

Version of Immich Mobile App

1.116.1

Platform with the issue

  • Server
  • Web
  • Mobile

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}:/usr/src/app/upload
      - /etc/localtime:/etc/localtime:ro
    env_file:
      - .env
    ports:
      - 2283:3001
    depends_on:
      - redis
      - database
    restart: always
    healthcheck:
      disable: true

  immich-machine-learning:
    container_name: immich_machine_learning
    # For hardware acceleration, add one of -[armnn, cuda, openvino] 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://immich.app/docs/features/ml-hardware-acceleration
    #   file: hwaccel.ml.yml
    #   service: cpu # set to one of [armnn, cuda, openvino, openvino-wsl] 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/redis:6.2-alpine@sha256:2d1463258f2764328496376f5d965f20c6a67f66ea2b06dc42af351f75248792
    healthcheck:
      test: redis-cli ping || exit 1
    restart: always

  database:
    container_name: immich_postgres
    image: docker.io/tensorchord/pgvecto-rs:pg14-v0.2.0@sha256:90724186f0a3517cf6914295b5ab410db9ce23190a2d9d0b9dd6463e3fa298f0
    environment:
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_USER: ${DB_USERNAME}
      POSTGRES_DB: ${DB_DATABASE_NAME}
      POSTGRES_INITDB_ARGS: '--data-checksums'
    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
    healthcheck:
      test: pg_isready --dbname='${DB_DATABASE_NAME}' --username='${DB_USERNAME}' || exit 1; Chksum="$$(psql --dbname='${DB_DATABASE_NAME}' --username='${DB_USERNAME}' --tuples-only --no-align --command='SELECT COALESCE(SUM(checksum_failures), 0) FROM pg_stat_database')"; echo "checksum failure count is $$Chksum"; [ "$$Chksum" = '0' ] || exit 1
      interval: 5m
      start_interval: 30s
      start_period: 5m
    command: ["postgres", "-c", "shared_preload_libraries=vectors.so", "-c", 'search_path="$$user", public, vectors', "-c", "logging_collector=on", "-c", "max_wal_size=2GB", "-c", "shared_buffers=512MB", "-c", "wal_compression=on"]
    restart: always

volumes:
  model-cache:



### Your .env content

```Shell
# 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=xxx
# The location where your database files are stored
DB_DATA_LOCATION=xxx

# 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=Etc/UTC

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

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

Reproduction steps

  1. Install docker cleanly (https://docs.docker.com/engine/install/debian/)
  2. Follow Immich setup (https://immich.app/docs/install/docker-compose)
  3. Bring up docker

Expected:
Docker is brought up successfully

Actual:
Container complains about trying to find the "sharp" module using the linux-arm64 runtime, then the container restarts.

Relevant log output

No response

Additional information

No response

Originally created by @virtualestate on GitHub (Sep 29, 2024). ### The bug On a fresh install of the latest version (1.116.2) of Immich on a Raspberry Pi 5 running Debian Bookworm, upon docker compose up for the first time, immich_server gets stuck in a restart loop outputting the following message: ``` immich_server | /usr/src/app/node_modules/sharp/lib/sharp.js:113 immich_server | throw new Error(help.join('\n')); immich_server | ^ immich_server | immich_server | Error: Could not load the "sharp" module using the linux-arm64 runtime immich_server | ERR_DLOPEN_FAILED: libvips-cpp.so.42: cannot open shared object file: No such file or directory immich_server | Possible solutions: immich_server | - Ensure optional dependencies can be installed: immich_server | npm install --include=optional sharp immich_server | - Ensure your package manager supports multi-platform installation: immich_server | See https://sharp.pixelplumbing.com/install#cross-platform immich_server | - Add platform-specific dependencies: immich_server | npm install --os=linux --cpu=arm64 sharp immich_server | - Consult the installation documentation: immich_server | See https://sharp.pixelplumbing.com/install immich_server | at Object.<anonymous> (/usr/src/app/node_modules/sharp/lib/sharp.js:113:9) immich_server | at Module._compile (node:internal/modules/cjs/loader:1469:14) ... ``` Error persists after restarting containers, docker and the physical device. Same error appears in 1.116.1 and 1.116.0. **WORKS AS EXPECTED IN 1.115.0** ### The OS that Immich Server is running on Debian 12 (Bookworm) ### Version of Immich Server 1.116.2 ### Version of Immich Mobile App 1.116.1 ### Platform with the issue - [X] Server - [ ] Web - [ ] Mobile ### 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}:/usr/src/app/upload - /etc/localtime:/etc/localtime:ro env_file: - .env ports: - 2283:3001 depends_on: - redis - database restart: always healthcheck: disable: true immich-machine-learning: container_name: immich_machine_learning # For hardware acceleration, add one of -[armnn, cuda, openvino] 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://immich.app/docs/features/ml-hardware-acceleration # file: hwaccel.ml.yml # service: cpu # set to one of [armnn, cuda, openvino, openvino-wsl] 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/redis:6.2-alpine@sha256:2d1463258f2764328496376f5d965f20c6a67f66ea2b06dc42af351f75248792 healthcheck: test: redis-cli ping || exit 1 restart: always database: container_name: immich_postgres image: docker.io/tensorchord/pgvecto-rs:pg14-v0.2.0@sha256:90724186f0a3517cf6914295b5ab410db9ce23190a2d9d0b9dd6463e3fa298f0 environment: POSTGRES_PASSWORD: ${DB_PASSWORD} POSTGRES_USER: ${DB_USERNAME} POSTGRES_DB: ${DB_DATABASE_NAME} POSTGRES_INITDB_ARGS: '--data-checksums' 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 healthcheck: test: pg_isready --dbname='${DB_DATABASE_NAME}' --username='${DB_USERNAME}' || exit 1; Chksum="$$(psql --dbname='${DB_DATABASE_NAME}' --username='${DB_USERNAME}' --tuples-only --no-align --command='SELECT COALESCE(SUM(checksum_failures), 0) FROM pg_stat_database')"; echo "checksum failure count is $$Chksum"; [ "$$Chksum" = '0' ] || exit 1 interval: 5m start_interval: 30s start_period: 5m command: ["postgres", "-c", "shared_preload_libraries=vectors.so", "-c", 'search_path="$$user", public, vectors', "-c", "logging_collector=on", "-c", "max_wal_size=2GB", "-c", "shared_buffers=512MB", "-c", "wal_compression=on"] restart: always volumes: model-cache: ``` ``` ### Your .env content ```Shell # 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=xxx # The location where your database files are stored DB_DATA_LOCATION=xxx # 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=Etc/UTC # 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=xxx # The values below this line do not need to be changed ################################################################################### DB_USERNAME=postgres DB_DATABASE_NAME=immich ``` ### Reproduction steps 1. Install docker cleanly (https://docs.docker.com/engine/install/debian/) 2. Follow Immich setup (https://immich.app/docs/install/docker-compose) 4. Bring up docker Expected: Docker is brought up successfully Actual: Container complains about trying to find the "sharp" module using the linux-arm64 runtime, then the container restarts. ### Relevant log output _No response_ ### Additional information _No response_
OVERLORD commented 2026-02-05 10:22:57 +03:00
Author
Owner
Copy Link

@alextran1502 commented on GitHub (Sep 30, 2024):

Hello, thank you for reporting. I'd like to confirm that your Debian installation on the Pi is a 64-bit version, correct?

@mertalev Any thoughts on this?

@alextran1502 commented on GitHub (Sep 30, 2024): Hello, thank you for reporting. I'd like to confirm that your Debian installation on the Pi is a 64-bit version, correct? @mertalev Any thoughts on this?
OVERLORD commented 2026-02-05 10:23:00 +03:00
Author
Owner
Copy Link

@virtualestate commented on GitHub (Sep 30, 2024):

Yeah, "...aarch64..." according uname -a and "64" according to getconf LONG_BIT.

@virtualestate commented on GitHub (Sep 30, 2024): Yeah, "...aarch64..." according `uname -a` and "64" according to `getconf LONG_BIT`.
OVERLORD commented 2026-02-05 10:23:04 +03:00
Author
Owner
Copy Link

@mertalev commented on GitHub (Sep 30, 2024):

Nothing strikes out to me as a possible reason why 1.115 works, but 1.116 doesn't in this case. I don't see any related changes in dependencies or the base image.

@mertalev commented on GitHub (Sep 30, 2024): Nothing strikes out to me as a possible reason why 1.115 works, but 1.116 doesn't in this case. I don't see any related changes in dependencies or the base image.
OVERLORD commented 2026-02-05 10:23:08 +03:00
Author
Owner
Copy Link

@virtualestate commented on GitHub (Nov 27, 2024):

Closing this issue as everything works as expected on version 1.121.0

@virtualestate commented on GitHub (Nov 27, 2024): Closing this issue as everything works as expected on version 1.121.0
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#4435
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?