Immich Redis

Immich Redis runs Valkey, a Redis-compatible in-memory data store, as the cache and message queue (the redis service from Immich's official compose setup) for…

  • Databases
  • Network Services
  • Other
  • Productivity
  • Tools & Utilities
Immich Redis runs Valkey, a Redis-compatible in-memory data store, as the cache and message queue (the redis service from Immich's official compose setup) for Immich, a self-hosted photo and video manager. It runs as a separate container on Immich's custom Docker network so the Immich server can reach it by container name. No configuration and no published ports are required, since it is only used internally over the shared network. It is required by the Immich server and is aimed at homelab users deploying Immich's split-container setup.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

65/100 Good

Maintained
95last commit 25 days ago
Popular
46200 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
206 GB minimum RAM, runs on ARM
Security check
95no serious findings, CI, tests

Availability: platform listings confirmed today, links checked 55 days ago

GitHub stars
200
Open issues
10
Last commit
2026-10-27
License
BSD-3-Clause
Activity
rising

Checked 23 days ago - source: GitHub (valkey-io/valkey-container)

Resources & Compatibility

Minimum requirements: 6 GB RAM, 2 CPU core(s). ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Set your Immich URL and API key Edit config.yaml and put your Immich server URL and application programming interface (API) key in immich_url and immich_api_key. These are required, and the kiosk will not show any photos without them. source
  • Use the downloaded config file Save the downloaded config.yaml in ./config and make sure the container can read it, because it holds the required Immich URL, API key, and display settings. Without a valid config file, the kiosk has nothing to connect to and will not show your photos. source
  • Launch the Android kiosk app Install either ImmichFrame or Fully Kiosk Browser, then use the Android Debug Bridge (adb) command from the docs to start it. If you skip this, the app is installed but does not automatically open the kiosk screen. source
  • First install No configuration or published ports are required. The container must join Immich's custom Docker network (immich) so the Immich server can reach it by its container name, immich-redis. source
  • No configuration needed The container needs no configuration and exposes no ports. It is added to Immich's custom Docker network and is reached by the Immich server by container name, so it stays internal to the stack. source

Fetched 17 days ago - each note links to its source

Alternatives (4)

  • KeyDB - KeyDB is a distributed, Redis-compatible key-value database that adds true multi-master replication, letting any number of servers accept w…
  • Redis - Redis is a fast, in-memory data structure store that can be used as a database, cache, and message broker.
  • memcached - Memcached is an in-memory key-value store for small chunks of arbitrary data (strings, objects) from results of database calls, API calls,…
  • ncache - NCache is a fast, scalable, open-source distributed cache for .NET applications that keeps frequently used data in a shared in-memory pool…

Checked 40 days ago - source: AlternativeTo

Common questions

How can I keep Immich from losing Redis or PostgreSQL connectivity after updates on UNRAID?

Assign static IPs to the Redis and PostgreSQL containers. This is the networking fix discussed for Immich failing to connect to its databases after updates.

Why are database and Redis password fields missing in the Immich TrueNAS setup UI?

The reported issue is that the Immich installation/configuration UI does not display database and Redis password fields. It can be used to diagnose missing configuration fields during app setup.

Will a Redis licensing change force Immich to replace Redis?

Responders say open-source Redis usage in projects like Immich is not affected by the licensing change.

When should a new Valkey container image be built and published?

A new Docker image should be built and published after a new major, minor, or patch version of Valkey is released in the main Valkey repository.

Answers sourced from forums.truenas.com, forums.unraid.net, github.com, www.reddit.com

Community

Collected 54 days ago - public community threads