peixotomdb/deadletter repository overview

⁠deadLetter

deadLetter is a local message debugging tool.

It captures SMTP email safely, stores the raw message plus parsed metadata, and gives you a web UI and HTTP API to inspect everything locally. It can also connect to Kafka and Redis so you can browse topics, messages, channels, keys, and live activity from one place.

⁠Quick start

docker pull peixotomdb/deadletter:latest

docker run -d \
  --name deadletter \
  -p 1025:1025 \
  -p 8025:8025 \
  -v "$PWD/data:/data" \
  peixotomdb/deadletter:latest

Open:

• UI and API: http://localhost:8025
• SMTP sink: localhost:1025

⁠Run with Kafka and Redis

docker run -d \
  --name deadletter \
  -p 1025:1025 \
  -p 8025:8025 \
  -v "$PWD/data:/data" \
  -e KAFKA_BROKERS=host.docker.internal:9092 \
  -e SCHEMA_REGISTRY_URL=http://host.docker.internal:8081 \
  -e REDIS_ADDR=host.docker.internal:6379 \
  peixotomdb/deadletter:latest

⁠What you get

• SMTP sink on 1025
• Web UI and HTTP API on 8025
• Email capture, replay, retention, and raw message inspection
• Optional Kafka and Redis observability
• Persistent data stored in /data

deadLetter is built for local development, QA, demos, and internal debugging workflows.