Skip to content

Migration Guides

Moving to glide-mq from another job queue library? These guides provide step-by-step conversion instructions, API mapping tables, and migration checklists.

Available Guides

From BullMQ

BullMQ is the most popular Redis-backed job queue for Node.js. The glide-mq API is intentionally similar - most changes are connection format and imports. Migration is straightforward with minimal code changes.

Key differences: Connection format (ioredis -> valkey-glide), script engine (Lua EVAL -> Valkey Server Functions), and new features (Broadcast, batch processing, compression, dedup).

From Bee-Queue

Bee-Queue uses a chained job builder pattern (queue.createJob(data).retries(3).save()) that differs more from glide-mq's options-based API. This guide covers the full conversion including the separated Queue/Worker pattern.

Why migrate: Bee-Queue is unmaintained (last release 2021), lacks cluster support, TLS, TypeScript types, and many features glide-mq provides out of the box.

What You Gain

All migration paths give you access to features your current library doesn't have:

FeatureDescription
1-RTT job operationsSingle FCALL round-trip per job
Rust NAPI coreLower latency, less GC pressure
Cluster-nativeHash-tagged keys, AZ-affinity routing
FlowProducerParent-child job trees and DAG workflows
BroadcastFan-out pub/sub with NATS-style subject filtering
Batch processingProcess multiple jobs per worker call
CompressionGzip with 98% reduction on 15KB payloads
DeduplicationSimple, throttle, and debounce modes
SchedulersCron patterns and interval repeatable jobs
Rate limitingGlobal and per-group limits
ServerlessConnection caching for Lambda/Edge
In-memory testingTestQueue/TestWorker without Valkey
Framework integrationsHono, Fastify, NestJS, Hapi, Dashboard

Released under the Apache-2.0 License.