V0.1 · Architecture & service documentation
← All services

Data & recovery / SERVICE DOCUMENTATION

Redis

An in-memory data service used where applications need a cache or broker.

V0.1 · Reviewed 29 October 2026Documentation snapshot · Not live status

01 / THE ROLE

In this lab.

The lab includes a central Redis service, and Paperless has its own Redis broker container in its application stack. These are distinct instances with potentially different responsibilities and recovery needs. It would be misleading to draw every Redis-dependent application as using one shared instance.

02 / THE CONNECTIONS

Follow the flow.

Redis · simplified flowSimplified flow
  1. STEP 01Application or worker
  2. STEP 02Redis connection
  3. STEP 03Cache or broker state
  4. STEP 04Consumer

03 / How it works

How it works.

Redis can hold state for several roles. The important question is what the specific consumer puts there: disposable cached results, queued work or state that must survive a restart. An application-specific broker should be documented with that application rather than inferred from the engine’s presence elsewhere.

04 / Persistent data & recovery

Persistent data & recovery.

Classify the data before choosing protection. Do not assume that all Redis data is disposable or that it all requires full archival recovery. The persistence configuration and the application’s tolerance for lost or replayed work determine the appropriate procedure.

05 / How to check it

How to check it.

Check connectivity, application workers and the effect of a controlled restart in a suitable test environment. A working RedisInsight interface is separate from the availability and correctness of the Redis instance being inspected.

06 / Decisions & limits

Decisions & limits.

The same technology can have very different operational meaning across services. I document its role per consumer rather than using the product name as the whole architecture.

KEEP EXPLORING

Related parts of the lab.