Open-source webhook infrastructure for developers.
Receive, inspect, deliver, retry, and replay webhooks with a self-hostable stack built for visibility and control.
Webhooks fail, and they usually fail silently. HookTrace shows you what happened to every event.
| When... | HookTrace lets you... |
|---|---|
| Webhooks fail silently | See whether an event arrived, what payload was received, and what happened during delivery. |
| Downstream services go down | Retry failed deliveries instead of losing events. |
| You need to debug production events | Inspect payloads, headers, providers, and delivery attempts. |
| You need to reproduce an event | Replay it without triggering the provider again. |
Webhook Provider
↓
HookTrace
↓
Receive → Inspect → Store → Deliver
↓
Retry / Replay
↓
Your Application
- Receive webhooks from any provider
- Inspect payloads, headers, and providers
- Store every event
- Deliver to your configured targets
- Retry failed deliveries
- Replay past events on demand
- Local webhook tunnels for development
- Provider integrations (see below)
- Metrics and observability
- Self-hosting with Docker Compose
git clone https://github.com/hooktracehq/hooktrace.git
cd hooktrace
cp .env.example .env
docker compose up -dOnce the stack is running:
| Service | URL |
|---|---|
| Dashboard | http://localhost:3000 |
| API | http://localhost:3001 |
| API Docs | http://localhost:3001/docs |
HookTrace tunnels let you receive real webhook requests locally without exposing your application directly to the public internet.
Provider concepts currently covered:
- Stripe
- GitHub
- Razorpay
- Shopify
- Slack
- Discord
- Notion
- Supabase
- Generic webhooks
Note: check each provider against the current code before release and mark anything that is not yet production-ready.
┌───────────────┐
│ Webhook │
│ Providers │
└───────┬───────┘
│
▼
┌───────────────┐
│ HookTrace │
│ API │
└───────┬───────┘
│
┌──────────┼──────────┐
▼ ▼ ▼
PostgreSQL Redis Workers
│
▼
Delivery Targets
Copy .env.example to .env and adjust the values for your environment.
Contributions are welcome. Open an issue to discuss larger changes, then submit a pull request.
- Fork the repository
- Create a feature branch
- Commit your changes
- Open a pull request
HookTrace is open source and released under the Apache License 2.0. Inspect the code, self-host the stack, modify it for your needs, and contribute.
- GitHub: https://github.com/hooktracehq/hooktrace
- Docs: http://localhost:3001/docs (when self-hosting)