viba88/warren repository overview

⁠Warren: dead-letter operations for RabbitMQ

Warren is a self-hosted web console for the dead-letter side of RabbitMQ. It runs as one container next to your broker and shows what is in a dead-letter queue without consuming it: payload, headers and the x-death history of every message, grouped by cause.

• Find out why messages died: group by reason, exception, queue or routing key; read the death history as a sentence; files inside payloads (PDF, CSV, JSON) show as files.
• Replay safely: selected messages, the first N or everything matching a filter, back to their original exchange and routing key, death headers stripped, publisher confirms, throttled.
• Park and discard: move poison messages to <queue>.parking with their history, or remove them with a reason.
• Audit log of every replay, park, discard, purge, publish and export, message by message.
• Alerts and replay rules (Team, Pro): Slack, Teams or webhook; transient failures replayed on a schedule, with limits.

RabbitMQ 3.13 and 4.x, classic and quorum queues. The Community edition is free for one cluster.

⁠Try it in a minute

A RabbitMQ, Warren and real dead letters in one compose file:

curl -O https://warrenops.io/docker-compose.try.yml
docker compose -f docker-compose.try.yml up -d

Open http://localhost:8080⁠ and sign in as admin / admin.

⁠Run it next to your broker

docker run -d -p 8080:8080 -v warren-data:/app/data \
  -e WARREN_RABBIT_MANAGEMENT_URL=http://rabbitmq:15672 \
  -e WARREN_RABBIT_HOST=rabbitmq \
  -e WARREN_RABBIT_USERNAME=warren -e WARREN_RABBIT_PASSWORD=change-me \
  -e WARREN_ADMIN_PASSWORD=change-me-too \
  viba88/warren:latest

The RabbitMQ user needs the management tag and read and write on the vhost.

⁠Links

• Website: https://warrenops.io⁠
• README, configuration, changelog: https://github.com/ViBa88/warren-releases⁠
• 4-minute walkthrough: https://youtu.be/npZHNMuwPew⁠

Tags: X.Y.Z, X.Y and latest, for linux/amd64 and linux/arm64. The same images are on ghcr.io/viba88/warren.