---
type: reference
title: Redis (RomM Cache / Queue)
description: "The Redis cache and task queue for RomM: quadlet unit, network alias topology, and the backup path."
tags: [redis, romm, dankserver]
timestamp: 2026-09-03T00:00:00Z
---

# Redis (RomM Cache / Queue)

Redis 7 provides the caching and task-queue backend for [[RomM]] on Dankserver.
RomM requires Redis (or Valkey) for its task queue; this deployment runs
stock `redis:7-alpine` — no Valkey here, unlike the SearXNG cache on
Dankclaw ([[Valkey]]).

**Host:** Dankserver — container name `romm-redis`, unit `romm-redis.service`
(user-manager quadlet from `dankserver/romm/quadlet/romm-redis.container`).

## Facts (verified from the live unit)

| Item | Value |
|------|-------|
| Image | `docker.io/library/redis:7-alpine` |
| Port | 6379 — internal only; no `PublishPort`, so it is unreachable from the host network by construction |
| Network | `dankserver_appnet` with `alias=redis` — that alias is what makes `REDIS_HOST=redis` in the RomM unit resolve |
| Data volume | `/home/dank/Containers/romm/redis:/data` |
| Auth | None — safe precisely because the container is not published anywhere; only appnet members can reach it |

## Unit shape (as deployed)

```ini
[Container]
ContainerName=romm-redis
Image=docker.io/library/redis:7-alpine
Network=dankserver_appnet:alias=redis
Volume=/home/dank/Containers/romm/redis:/data
HealthCmd=redis-cli ping
HealthInterval=10s
HealthTimeout=5s
HealthRetries=3

[Service]
Restart=always
RestartSec=5

[Install]
WantedBy=default.target
```

No `EnvironmentFile` — there is nothing secret in this unit; the auth-less
posture is enforced by network topology (alias-only reachability), not by a
password. If a future client ever needs Redis from outside the appnet, add
`PublishPort` **and** a `requirepass` in the same change — never just the port.

## Backup

```bash
sudo rsync -a /home/dank/Containers/romm/redis /mnt/backup/romm-redis/
```

Redis here is cache + queue state; losing it costs queued jobs and cache warm,
not the library (the database lives in [[MariaDB]]).

## See Also

- [[RomM]] — service that uses this cache
- [[Valkey]] — the SearXNG-side equivalent on Dankclaw