Lucia-Redis

Lucia-Redis

Official

Docker app from Lucia's Repository

Overview

Redis cache and task persistence for Lucia. Before installing, run `docker network create lucia` in the Unraid terminal. Install this template before Lucia.

Unraid Community Apps

Unraid requires one XML template per container. Lucia therefore ships three linked templates:

Install

Create the user-defined bridge network before installing any template. Each template selects it through <Network>lucia</Network>.

Run this once in the Unraid terminal:

docker network create lucia
mkdir -p /mnt/cache/appdata/lucia/postgres-init /mnt/cache/appdata/lucia/models
curl -fsSL https://raw.githubusercontent.com/seiggy/lucia-dotnet/master/infra/unraid/init.sql \
  -o /mnt/cache/appdata/lucia/postgres-init/init.sql
chown -R 1100:1100 /mnt/cache/appdata/lucia/models

If your cache pool is not named cache, change the template paths before installing.

Install the templates in this order:

  1. Lucia-PostgreSQL. Set a long database password containing only letters and numbers.
  2. Lucia-Redis.
  3. Lucia. Replace CHANGE_ME in all three PostgreSQL connection strings with the same database password.

Open http://<unraid-ip>:7233 and complete the setup wizard.

PostgreSQL reads init.sql only when its data directory is empty. To repair an existing installation that started without it, create the missing databases before starting Lucia:

docker exec Lucia-PostgreSQL createdb -U lucia luciaconfig
docker exec Lucia-PostgreSQL createdb -U lucia luciatraces
docker exec Lucia-PostgreSQL createdb -U lucia luciatasks

Install Lucia-Redis on Unraid in a few clicks.

Find Lucia-Redis 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 Lucia-Redis Review the template variables and paths Click Install

Requirements

Before installing, run `docker network create lucia` in the Unraid terminal. Install Lucia-PostgreSQL and Lucia-Redis before Lucia.

Categories

Download Statistics

10,978,293,971
Total Downloads
107,523,278
This Month
113,164,059
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

Repository
redis:8.2-alpine
Last Updated2026-07-16
First Seen2018-05-06

Runtime arguments

Network
lucia
Shell
sh
Privileged
false
Extra Params
--restart=unless-stopped --health-cmd="redis-cli ping" --health-interval=10s --health-timeout=5s --health-retries=5

Template configuration

DataPathrw

Persistent Redis data on the cache pool.

Target
/data
Default
/mnt/cache/appdata/lucia/redis
Append-only persistenceVariable

Write each change to the append-only persistence file.

Target
REDIS_APPENDONLY
Default
yes
Maximum memoryVariable

Redis memory limit. Increase this for larger installations.

Target
REDIS_MAXMEMORY
Default
256mb
Eviction policyVariable

Policy used when Redis reaches its memory limit.

Target
REDIS_MAXMEMORY_POLICY
Default
allkeys-lru
Log levelVariable

Redis log verbosity.

Target
REDIS_LOGLEVEL
Default
notice
TimezoneVariable

Container timezone.

Target
TZ
Default
Etc/UTC
PortPorttcp

Optional host port for external Redis tools. Lucia does not need it.

Target
6379