@nostrwatch/redis runs a BullMQ queue monitoring dashboard for the nostr-watch monorepo. It launches a Fastify HTTP server with the bull-board UI, connecting to Redis to inspect queue state across one or more regional worker processes. Developers use it during local development to observe job throughput, failures, and retries in the BullMQ queues that drive relay monitoring.
This is an internal monorepo package. Add it as a workspace dependency:
pnpm add @nostrwatch/redis --filter @nostrwatch/your-packageIt is not published to npm.
Start the dashboard server directly:
node index.jsThe server listens on http://0.0.0.0:3030/f by default. Configure the Redis connection and monitored regions using environment variables (see Configuration).
Set the following environment variables before starting the server. Create a .env file in this directory or set them in your shell.
| Variable | Default | Description |
|---|---|---|
REDIS_HOST |
localhost |
Redis server hostname |
REDIS_PORT |
6379 |
Redis server port |
REDIS_USER |
(empty) | Redis ACL username (optional) |
REDIS_PASS |
(empty) | Redis password (optional) |
REDIS_TLS |
false |
Enable TLS for the Redis connection |
REGIONS |
(empty) | Comma-separated list of region names to monitor (e.g. us-east,eu-west) |
A docker-compose.yaml is included for running Redis locally:
docker compose up -dThis starts Redis on the default port 6379 with data persisted to .redis/.
No known limitations at this time.