Redis Manager

Manages the shared Redis Docker container for local dev environments.

Architecture

redis-manager/
├── docker-compose.yml   # Redis 7 Alpine container
└── run.sh               # lifecycle + data inspection CLI

Joins the shared nginx-proxy_net network (created by proxy-manager) so all app containers can connect via hostname codai_redis. Data is persisted in a named volume.

Commands

./run.sh start                # start Redis container
./run.sh stop                 # stop container (data persists in volume)
./run.sh status               # status + key count + memory usage
./run.sh wait                 # block until Redis responds PONG
./run.sh flush                # FLUSHALL — clear all data (interactive confirm)
./run.sh flush-db <n>         # FLUSHDB on database N (interactive confirm)
./run.sh list-keys [<pattern>]# KEYS <pattern> (default: *)
./run.sh cli                  # open redis-cli interactive session

How to Execute Tasks

Start Redis

cd redis-manager && ./run.sh start

Check status and memory usage

./run.sh status

Inspect keys for a specific instance

./run.sh list-keys "session:*"
./run.sh list-keys "cache:feature*"

Flush session data for testing

./run.sh flush-db 0    # flush default db only

Startup Order

1. proxy-manager start — creates the shared Docker network
2. mysql-manager start (or postgres-manager start)
3. redis-manager start

Configuration

App Connection

Backend containers connect to Redis at:

• Host: codai_redis (container name on shared network)
• Port: 6379
• Password: redispass (or REDIS_PASSWORD)

Rules

• flush always prompts for confirmation — it deletes all data in all databases.
• stop preserves data in the Docker volume. Use docker compose down -v only to wipe.
• Redis connects to the nginx-proxy_net network as external: true — proxy-manager must start first.

Related Plugins

• proxy-manager — creates the shared Docker network (start first)
• mysql-manager — relational DB companion
• postgres-manager — relational DB companion
• worktree-manager — app instances that consume Redis