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.

Install immich-valkey on Unraid in a few clicks.

Find immich-valkey in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for immich-valkey Review the template variables and paths Click Install

Requirements

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

Download Statistics

194,194,578
Total Downloads
29,320,554
This Month
23,884,537
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Details

Repository
valkey/valkey:latest
Last Updated2026-06-25
First Seen2025-02-18

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