MCPcopy Index your code
hub / github.com/durabullhq/durabull

github.com/durabullhq/durabull @v1.16.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.16.0 ↗ · + Follow
2,329 symbols 6,687 edges 564 files 91 documented · 4%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Durabull dashboard hero

Durabull

The modern dashboard for BullMQ.

Monitor queues, inspect jobs, debug failures, and operate workers across Redis environments.

<a href="https://durabull.io/documentation"><strong>Documentation</strong></a>
<span> · </span>
<a href="https://durabull.io"><strong>Hosted Product</strong></a>

Project

Durabull is an open-source BullMQ operations platform built for teams that need visibility and control over background jobs.

  • Queue and job visibility across multiple Redis connections
  • Worker and scheduler diagnostics
  • Redis key exploration tailored for BullMQ patterns
  • Local-first development with Bun + TypeScript in a monorepo

Run locally

Prerequisites

  • Bun 1.3+
  • Node.js 20.19+ or 22.12+ for the Vite web app
  • Redis (local or remote)

Fastest path (authless)

bun install
bun run dev:authless

Open:

  • Web: http://localhost:5173
  • API: http://localhost:3001/api

dev:authless is for local/private environments. Do not expose authless mode directly to the public internet.

Full local stack (Postgres + Redis + seeded data)

bun docker
bun docker:seed
bun run dev

Optional demo traffic generator:

bun run workload:dev

If you want API + web + workload in one terminal, use:

bun run dev:demo

Helpful links

Anonymous usage telemetry

Production and self-hosted Durabull collects anonymous/pseudonymous usage telemetry to understand feature usage and improve the product. Configuring POSTHOG_KEY for your own PostHog project does not disable Durabull telemetry, and Durabull does not provide a product-level telemetry opt-out. When POSTHOG_KEY is set, the configured PostHog project still receives the full PostHog browser analytics stream.

Durabull does not collect Redis URLs, queue names, Redis key names, job data, logs, emails, names, organizations, hostnames, raw URLs, search patterns, stack traces, or raw error messages.

Useful repo guides

Monorepo at a glance

  • apps/api - Bun + Hono API
  • apps/web - React dashboard app
  • apps/docs - Next.js documentation site
  • packages/* - shared auth, DAL, analytics, utilities, and demo workload packages

License

Elastic License 2.0 (ELv2). See LICENSE.

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Function 1,819
Interface 397
Method 65
Class 48

Languages

TypeScript100%

Modules by API surface

apps/web/src/hooks/use-alerts.ts62 symbols
apps/web/src/hooks/use-queues.ts41 symbols
packages/mcp/src/tools/register-read-tools.ts34 symbols
apps/web/src/routes/$orgSlug.c.$connectionId.analytics.tsx33 symbols
apps/api/src/lib/alert-notifier.ts31 symbols
apps/api/src/lib/linear-client.ts29 symbols
apps/web/src/components/alerts/alert-rule-form.ts28 symbols
packages/fleet-demo-workload/src/connection-runtime.ts27 symbols
apps/web/src/routes/$orgSlug.c.$connectionId.queues.$queueName.tsx27 symbols
tooling/scripts/seed/utils.ts26 symbols
apps/api/src/lib/alert-monitor.ts26 symbols
packages/dal/src/repositories/alert-event.ts25 symbols

For agents

$ claude mcp add durabull \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page