# Immich Redis

Immich Redis is a self-hosted databases app. Valkey is a Redis-compatible in-memory data store used by Immich, a self-hosted photo and video manager, as its cache and message queue (the redis service from Immich's official compose setup). It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/29/immich-redis

## Description

Valkey is a Redis-compatible in-memory data store used by Immich, a self-hosted photo and video manager, as its cache and message queue (the redis service from Immich's official compose setup). 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 9 platforms: Unraid.

## Health score

58/100 (Fair), based on 4 of 4 factors.
- Maintained: 92 (last commit 36 days ago)
- Popular: 46 (200 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 20 (6 GB minimum RAM, runs on ARM)

## Links

- GitHub: https://github.com/valkey-io/valkey-container
- Docker Hub: https://hub.docker.com/r/valkey/valkey
- Unraid: https://ca.unraid.net/apps/immich-redis-155t2hz0h3bs4b?q=immich-redis
- Official website: https://valkey.io/

## 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.

## Alternatives

- 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…

---
Source: Our Local Host (https://ourlocalhost.com/app/29/immich-redis), the self-hosted and open-source app directory.