Redis WebUI
What is Redis WebUI?
Redis WebUI is a lightweight browser-based admin panel for Redis: browse keys, inspect values, and run basic operations without touching redis-cli. In Laradock it's pre-wired to connect to the redis service automatically.
Start Redis WebUI
docker compose up -d redis-webui
The container's compose.yml declares depends_on: redis, so docker compose up -d redis-webui also starts redis if it isn't running yet.
Stop Redis WebUI
docker compose stop redis-webui
Configuration
All settings live in redis-webui/defaults.env and can be overridden by adding the same line to your own .env:
| Variable | Default | What it does |
|---|---|---|
REDIS_WEBUI_USERNAME | laradock | Login username for the web panel. |
REDIS_WEBUI_PASSWORD | laradock | Login password for the web panel. |
REDIS_WEBUI_CONNECT_HOST | redis | Host of the Redis instance the panel connects to (the redis container name). |
REDIS_WEBUI_CONNECT_PORT | 6379 | Port of that Redis instance (container-internal, not REDIS_PORT). |
REDIS_WEBUI_PORT | 9987 | Host-side port the web panel itself is published on. |
The panel's Redis connection also picks up REDIS_PASSWORD (defined in the main .env, shared with the redis service) to authenticate.
Log in
Open http://localhost:9987 (or your custom REDIS_WEBUI_PORT) and sign in with REDIS_WEBUI_USERNAME / REDIS_WEBUI_PASSWORD. It should already be connected to the redis container, no extra connection setup needed for the default single-instance setup.
Point it at a different Redis instance
Set REDIS_WEBUI_CONNECT_HOST and REDIS_WEBUI_CONNECT_PORT in .env to another container's name and internal port (for example valkey and 6379), then restart:
docker compose up -d redis-webui
Common issues
- Blank data or "connection refused" in the panel. The
rediscontainer isn't up yet or crashed. Checkdocker compose logs redisand confirm it's healthy before reloading the panel. - Login fails with the default credentials. Someone already changed
REDIS_WEBUI_USERNAME/REDIS_WEBUI_PASSWORDin.env; check there before assuming a bug. - Panel shows no keys even though your app is caching. Double-check
REDIS_WEBUI_CONNECT_HOST/PORTactually point at the Redis instance your app writes to; if you run multiple Redis-compatible services (Redis, Valkey, Dragonfly), it's easy to point the UI at the wrong one.
Prefer the command line? See Redis for redis-cli usage. New to Laradock? Start at Getting Started.