Deploy and Host Bull Board on Railway

Bull Board is a production-ready web dashboard for monitoring and managing BullMQ job queues. Built on Hono, it features automatic queue discovery, multi-Redis support, and built-in HTTP Basic Auth — giving you real-time visibility into your background jobs with zero manual queue registration.

About Hosting Bull Board

Hosting Bull Board requires a running Redis instance that your BullMQ workers also connect to. The dashboard connects to Redis, periodically scans for queues, and surfaces them automatically — no config changes needed as your app grows. This template deploys three services on Railway: the Bull Board dashboard, a pre-configured Redis instance, and an example worker that populates sample queues so you see a live dashboard immediately. Authentication is handled via HTTP Basic Auth, configured through environment variables. For multi-service architectures, Bull Board can monitor multiple Redis instances simultaneously from a single deployment using the REDIS_INSTANCES config.

Common Use Cases

Monitor background jobs in real time — email sending, report generation, webhook delivery, and data pipelines
Debug failed jobs by inspecting error stack traces, then retrying or removing them directly from the UI
Get ops visibility across multi-service architectures with a single dashboard spanning multiple Redis instances

Dependencies for Bull Board Hosting

Redis — Bull Board connects to one or more Redis instances where BullMQ stores its job data
BullMQ workers — your application services that enqueue and process jobs; queues are auto-discovered once workers connect to the same Redis

Deployment Dependencies

Bull Board — the open-source BullMQ dashboard UI
BullMQ — Redis-backed job queue for Node.js
Hono — ultrafast web framework used to serve the dashboard
ioredis — Redis client with reconnection and TLS support
Zod — runtime config validation so misconfigurations fail fast at startup

Implementation Details

To monitor multiple Redis instances from a single Bull Board deployment, set REDIS_INSTANCES to a JSON array:

[
  { "name": "primary", "host": "redis-primary.railway.internal", "port": 6379 },
  { "name": "cache-jobs", "host": "redis-cache.railway.internal", "port": 6379 }
]

For Railway's private networking, set REDIS_FAMILY=6 to force IPv6. A health check endpoint is available at GET /healthz — it returns connection status for every configured Redis instance and integrates with Railway's built-in health checks automatically.

Why Deploy Bull Board on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Bull Board on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.