Open Task Force

An open-source BullMQ dashboard UI built with Next.js. A free alternative to Taskforce.sh.

Features

Queue Management

• Auto-discovery - Automatically discovers all BullMQ queues from Redis
• Sidebar navigation - Easy queue switching with real-time stats
• Pause/Resume - Pause and resume queue processing
• Clean jobs - Bulk clean completed or failed jobs

Jobs

• View all jobs - Browse jobs by status (waiting, active, delayed, completed, failed)
• Job details - View job data, options, return value, and stacktrace
• Add job - Create new jobs with custom data, delay, and attempts
• Clone job - Duplicate existing jobs with one click
• Retry job - Retry failed jobs
• Remove job - Delete individual jobs
• Pagination - Navigate through large job lists with clickable page numbers

Metrics

• Currently Queued - Total, Waiting-Children, Waiting, Prioritized, Delayed, Active
• Processed - Completed/Failed percentages with totals
• Response Time - Min, Median, Max time spent in queue
• Process Time - Min, Median, Max time spent in workers
• Throughput - Jobs processed per minute

Schedulers (Repeatable Jobs)

• View schedulers - See all configured repeatable jobs
• Cron patterns - Display cron expressions and intervals
• Next run - Show next scheduled execution time
• Remove scheduler - Delete repeatable job configurations

Workers

• Connected workers - View all workers connected to the queue
• Worker details - IP address, connection age, idle time
• Real-time status - See active worker connections

Settings

• Queue info - Name, prefix, Redis key
• BullMQ version - Version of BullMQ being used
• Total jobs - Count of all jobs ever created
• Raw metadata - View all Redis metadata

Quick Start

docker run -d \
  -p 3000:3000 \
  -e REDIS_URL=redis://your-redis-host:6379 \
  jdaviderb/open-task-force

Open http://localhost:3000 to view the dashboard.

With Basic Auth

docker run -d \
  -p 3000:3000 \
  -e REDIS_URL=redis://your-redis-host:6379 \
  -e BASIC_AUTH_USERNAME=admin \
  -e BASIC_AUTH_PASSWORD=your-secure-password \
  jdaviderb/open-task-force

Environment Variables

Variable	Default	Description
REDIS_URL	redis://127.0.0.1:6379	Redis connection URL
BASIC_AUTH_USERNAME	-	Username for Basic Auth (optional)
BASIC_AUTH_PASSWORD	-	Password for Basic Auth (optional)

Security

Important: You are responsible for securing access to this dashboard.

This dashboard provides full visibility and control over your BullMQ queues. We recommend:

1. Network-level security (recommended): Restrict access using firewall rules, VPN, or private networks. Only allow connections from trusted IPs.

2. Basic Auth: If network-level restrictions are not possible, enable Basic Auth by setting both BASIC_AUTH_USERNAME and BASIC_AUTH_PASSWORD environment variables.

3. Never expose publicly: Do not expose this dashboard to the public internet without proper security measures.

Tech Stack

• Next.js 16 - React framework with App Router
• TypeScript - Type-safe code
• Tailwind CSS - Utility-first styling
• ioredis - Redis client (direct connection, no bullmq dependency)

Architecture

Open Task Force connects directly to Redis using ioredis without requiring the bullmq library. This makes it lightweight and allows monitoring queues from any BullMQ application.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - feel free to use this in your own projects.

Acknowledgments

• Inspired by Taskforce.sh
• Built for the BullMQ community