immich-valkey

immich-valkey

Official

Docker app from rorar's Repository

Overview

Valkey is an open-source, high-performance key/value store (Redis fork). Used by Immich as a cache and job queue (BullMQ).

This is a lightweight component. Must be on the same Docker network as the Immich server.

Tuning (via Post Arguments):

  • maxmemory 0 (unlimited). For low-memory systems, change to 256mb.
  • appendonly yes. Enables job queue persistence across container restarts.
  • tcp-keepalive 60. Faster dead connection detection in Docker networks (default: 300).

Storage sizing recommendations:

  • Small (10k photos): 1-2GB
  • Medium (10k-50k photos): 2-5GB
  • Large (50k photos): 5-10GB

Note: Immich officially uses Valkey (not Redis) since their docker-compose.yml references valkey/valkey:9.

Requirements

Must be on the same Docker network as the immich-server container. Full setup guide: https://rorar.github.io/immich-unraid-manual/

Runtime arguments

Network
immich_internal
Shell
sh
Privileged
false
Extra Params
--health-cmd="valkey-cli ping || exit 1" --health-interval=10s --health-retries=5 --health-start-period=10s --health-timeout=5s

Template configuration

Path: DataPathrw

Persistent Valkey data directory. Stores RDB snapshots and AOF logs for job queue persistence.

Target
/data
Default
/mnt/user/appdata/immich-valkey/
Value
/mnt/user/appdata/immich-valkey/
--- System ---Variable

General settings.

Variable: TZVariable

Timezone. See: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List

Target
TZ
Default
Europe/Berlin
Value
Europe/Berlin

Download Statistics

164,874,024
Total Downloads

Details

Repository
valkey/valkey:latest
Last Updated2026-05-28
First Seen2025-02-18

Run immich-valkey on Unraid.

immich-valkey is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.