immich-valkey
immich-valkey
OfficialDocker 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
Categories
Download Statistics
164,874,024
Total Downloads
Details
Repository
valkey/valkey:latestLast 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.