{"id":44441,"library":"bull-master","title":"Bull Master","description":"Bull Master is a UI dashboard for monitoring and managing Bull queues in Node.js applications. Version 1.0.5 provides a web interface to inspect jobs, retry failures, and clean completed/failed jobs. It integrates with Express or Koa as middleware. Different from alternatives like bull-board (which also supports BullMQ), Bull Master is specific to Bull and offers a simple setup. It relies on Bull and Redis being installed separately. The library does not process jobs itself; it only visualizes queue state. Updated occasionally, with limited features compared to more active projects.","status":"active","version":"1.0.5","language":"javascript","source_language":"en","source_url":"https://github.com/hans-lizihan/bull-master","tags":["javascript","bull","redis","queue","monitoring"],"install":[{"cmd":"npm install bull-master","lang":"bash","label":"npm"},{"cmd":"yarn add bull-master","lang":"bash","label":"yarn"},{"cmd":"pnpm add bull-master","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency: Bull Master visualizes Bull queues, so Bull must be installed.","package":"bull","optional":false}],"imports":[{"note":"This package does not ship TypeScript definitions; use require() for CommonJS.","wrong":"import bullMaster from 'bull-master'","symbol":"bullMaster","correct":"const bullMaster = require('bull-master')"},{"note":"bullMaster is a function, not a class. Do not use 'new'.","wrong":"const bullMasterApp = new bullMaster({ queues: [...] })","symbol":"bullMasterApp","correct":"const bullMasterApp = bullMaster({ queues: [someQueue] })"},{"note":"For Koa, you must specify a prefix option and use router.all, not app.use directly.","wrong":"app.use(bullMaster.koa({ queues: [someQueue] }))","symbol":"bullMaster.koa","correct":"router.all('/admin/queues*', bullMaster.koa({ queues: [someQueue], prefix: '/admin/queues' }))"}],"quickstart":{"code":"const express = require('express');\nconst Queue = require('bull');\nconst bullMaster = require('bull-master');\nconst app = express();\n\nconst videoQueue = new Queue('video processing', 'redis://127.0.0.1:6379');\nconst imageQueue = new Queue('image processing', 'redis://127.0.0.1:6379');\n\nconst bullMasterApp = bullMaster({\n  queues: [videoQueue, imageQueue],\n});\n\napp.use('/admin/queues', bullMasterApp);\n\napp.listen(3000, () => {\n  console.log('Bull Master UI available at http://localhost:3000/admin/queues');\n});","lang":"javascript","description":"Sets up an Express server with Bull Master to monitor two Bull queues at /admin/queues."},"warnings":[{"fix":"Pass an array of created Bull Queue objects: bullMaster({ queues: [queueInstance] })","message":"bullMaster() must be called with an array of Bull Queue instances, not queue names.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Add prefix: '/admin/queues' option when using bullMaster.koa() and use router.all with the wildcard route.","message":"For Koa, you must set the 'prefix' option to match the route path, otherwise the UI will not load correctly.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Test compatibility with your Bull version; consider using bull-board for ongoing support.","message":"No breaking changes reported for this version. However, the package has low activity and may not work with newer Bull versions.","severity":"deprecated","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'1.0.5':19 'activ':92 'also':49 'altern':43 'applic':17 'board':47 'bull':1,3,13,46,52,57,66,95 'bull-board':45 'bullmq':51 'clean':30 'compar':89 'completed/failed':31 'dashboard':8 'differ':41 'express':36 'failur':28 'featur':88 'inspect':25 'instal':70 'integr':34 'interfac':23 'javascript':94 'job':26,32,77 'koa':38 'librari':73 'like':44 'limit':87 'manag':12 'master':2,4,53 'middlewar':40 'monitor':10,98 'node.js':16 'occasion':85 'offer':59 'process':76 'project':93 'provid':20 'queue':14,82,97 'redi':68,96 'reli':64 'retri':27 'separ':71 'setup':62 'simpl':61 'specif':55 'state':83 'support':50 'ui':7 'updat':84 'version':18 'visual':81 'web':22","created_at":"2026-06-07T12:50:09.534593+00:00","updated_at":"2026-06-07T12:50:09.534593+00:00","problems":[{"fix":"Install bull: npm install bull","cause":"Bull is not installed as a peer dependency.","error":"Cannot find module 'bull'"},{"fix":"Use const bullMaster = require('bull-master')","cause":"Using import statement instead of require; the package does not support ESM.","error":"bullMaster is not a function"},{"fix":"Remove 'new': const bullMasterApp = bullMaster({ queues: [...] })","cause":"Creating bull master app with new bullMaster() instead of calling bullMaster() as a function.","error":"TypeError: Cannot read property 'getQueues' of undefined"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/hans-lizihan/bull-master","github":"https://github.com/hans-lizihan/bull-master","docs":null,"changelog":null,"pypi":null,"npm":"bull-master","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}