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
Screenshot_From_2025-09-20_14-00-13.png
Was this page helpful?