Β© 2026 Hedgehog Software, LLC

TwitterGitHubDiscord
More
CommunitiesDocsAboutTermsPrivacy
Search
Star
Setup for Free
ImmichI
Immichβ€’5mo agoβ€’
6 replies
cave monster

redis to valkey change: 'requirepass' not respected

The current docs section on secrets has a note linking to a redis issue comment for how to set up docker secrets to provide a password:
https://immich.app/docs/install/environment-variables/

However, the current compose files specify valkey instead of redis. Valkey does not seem to accept this same solution. Additionally, the healthcheck ping command may not work without providing the same password. I found a valkey specific issue here:
https://github.com/valkey-io/valkey-container/issues/71

Should Immich docs be updated to not hotlink to a redis-only docker secret 'requirepass' solution, given the current suggested configuration uses valkey?
Secondarily, is it possible to update docs to cover a solution applicable to valkey? I don't yet have enough of a working config to write a PR for it.

Relevant compose section in use, and a comand output from immich-server container
services:
  immich-server:
    image: ghcr.io/immich-app/immich-server:v1.142.1
    secrets:
      - postgres_password
      - redis_password
    environment:
      REDIS_PASSWORD_FILE: /run/secrets/redis_password
      ...
    ...

  redis:
    image: docker.io/valkey/valkey:8-bookworm@sha256:fea8b3e67b15729d4bb70589eb03367bab9ad1ee89c876f54327fc7c6e618571
    secrets:
      - redis_password
    environment:
      REDIS_PASSWORD_FILE: /run/secrets/postgres_password
    command: [
      "bash", "-c",
      '
      docker-entrypoint.sh
      --requirepass "$$(cat $$REDIS_PASSWORD_FILE)"
      '
    ]
    healthcheck:
      test: redis-cli ping || exit 1
    restart: unless-stopped

secrets:
  redis_password:
    file: /path/to/my/secrets/REDIS_PASSWORD.txt
services:
  immich-server:
    image: ghcr.io/immich-app/immich-server:v1.142.1
    secrets:
      - postgres_password
      - redis_password
    environment:
      REDIS_PASSWORD_FILE: /run/secrets/redis_password
      ...
    ...

  redis:
    image: docker.io/valkey/valkey:8-bookworm@sha256:fea8b3e67b15729d4bb70589eb03367bab9ad1ee89c876f54327fc7c6e618571
    secrets:
      - redis_password
    environment:
      REDIS_PASSWORD_FILE: /run/secrets/postgres_password
    command: [
      "bash", "-c",
      '
      docker-entrypoint.sh
      --requirepass "$$(cat $$REDIS_PASSWORD_FILE)"
      '
    ]
    healthcheck:
      test: redis-cli ping || exit 1
    restart: unless-stopped

secrets:
  redis_password:
    file: /path/to/my/secrets/REDIS_PASSWORD.txt
Screenshot_From_2025-09-20_14-00-13.png
ImmichJoin
A place to hang out, get support, discuss Immich, get announcements about releases and anything else going on.
36,590Members
Resources

Similar Threads

Was this page helpful?
Recent Announcements

Similar Threads

Failing to start Docker, connection to Valkey/Redis timed out
ImmichIImmich / help-desk-support
10mo ago
error with Valkey's image for the Redis service
ImmichIImmich / help-desk-support
10mo ago
Redis Auth Issue After Switching to Valkey – Immich Won’t Start
ImmichIImmich / help-desk-support
6mo ago
THUMB_LOCATION not respected?
ImmichIImmich / help-desk-support
2mo ago