Graphile Worker: PostgreSQL Job Queue
worker.graphile.org · checked 15 Oct 2026
An open-source PostgreSQL job queue that runs background tasks with Node.js workers.
How it plugs in
Signal on Task Queue Software7.6#4 of 37
Graphile Worker uses PostgreSQL to hold background jobs while Node.js workers process them. It supports retries, future and recurring schedules, concurrent workers, named queues, deduplication, batching, and database or Node APIs. It is self-hosted and free under the MIT license, but requires PostgreSQL 12 or newer and Node.js 22.18 or newer.
Review
In a line
Graphile Worker is a self-hosted job queue for applications built with PostgreSQL and Node.js. It moves background work out of normal application responses.
What it does
Jobs reside in PostgreSQL, where Node.js workers invoke JavaScript or TypeScript task functions. Workers can process jobs at the same time, while named queues can run related jobs in order.
Failed tasks are retried automatically with increasing delays. You can run jobs later with runAt or run_at, create recurring crontab-like schedules, and optionally backfill missed runs.
Unique job keys can replace, update, debounce, or deduplicate queued work. Batch jobs can collect array payloads before processing. The feature list reports that jobs generally begin execution in less than 3 milliseconds.
How it connects
A public SQL function, graphile_worker.add_job, lets applications, database triggers, and database functions add jobs. A Node.js API includes run, makeWorkerUtils, addJob, quickAddJob, and event interfaces for embedded workers.
You can deploy it as a command-line service or embed it in the application server's Node.js process. An official Docker image accepts command-line options and mounted task folders. PostgreSQL connections can use SSL and a configured certificate authority.
The core project uses the MIT open-source license. It pairs with PostGraphile, PostgREST, and other database-focused frameworks. npm, Yarn, and pnpm can install the package; global installation is not recommended. Custom behavior uses Graphile Config presets and plugins.
Good fit
It suits organizations already using PostgreSQL and Node.js that want one database-backed queue to maintain. It handles background tasks, delayed work, recurring jobs, retries, concurrent processing, and serialized named queues.
The software supports Linux, macOS, Windows, an API, and self-hosted deployment. Graphile Discord provides community help, while the maker also offers professional support contracts.
Watch for
For the current release, PostgreSQL 12 or newer and Node.js 22.18 or newer are required. PostgreSQL remains the bottleneck as load rises; the documentation suggests considering another queue around 5,000 or more jobs per second. Official benchmarks report roughly 183,000 trivial jobs per second with batching, with average start latency near 4 milliseconds.
The maker describes it as intended for regular organizations rather than as a replacement for dedicated queues at Facebook scale. The core queue has no dead-letter queue. Experimental executable-file tasks run only on Linux or Unix systems.
Some database migrations can break compatibility and may require stopping workers during an upgrade. Only the latest release generally receives security updates. Worker Pro provides recovery for crashed workers and migration of live workloads to newer Worker versions, under a proprietary source-available license.
Pricing
The core Graphile Worker software costs nothing and is released under the MIT license. The Graphile Worker OSS plan is also free, self-hosted, and PostgreSQL-backed. There is no free trial because the core software is already free.
Verdict
Choose Graphile Worker when PostgreSQL is already central to your application and you want background processing without operating a separate queue service. Its SQL and Node interfaces, embedded mode, schedules, retries, and deduplication cover common application workloads.
Look elsewhere if you need a queue that does not depend on PostgreSQL, a built-in dead-letter queue, or a design aimed at very large dedicated-queue workloads.
Our take
Graphile Worker is a practical match for a PostgreSQL-and-Node.js stack that needs scheduled, delayed, retryable, or batched background work. Its self-hosted MIT core keeps the basic cost at zero, and its SQL interface can fit database-driven applications. The tradeoff is architectural: PostgreSQL stores and schedules the jobs, so database capacity sets the ceiling.
- Free, open-source core under the MIT license
- Failed tasks are retried with exponential backoff
- Supports future and recurring schedules with optional backfill
- SQL and Node.js APIs support database or embedded use
- Job keys provide replacement, updating, debouncing, and deduplication
- Requires PostgreSQL 12+ and Node.js 22.18+
- Throughput can fall when PostgreSQL is the bottleneck
- No built-in dead-letter queue
- Some upgrades may require stopping existing workers
- Worker Pro uses a proprietary source-available license
- Pick it ifPostgreSQL and Node.js applications; Self-hosted background jobs, schedules, and retries; Teams avoiding a separate queue infrastructure component
- Skip it ifYou need a queue independent of PostgreSQL; You require a built-in dead-letter queue; You operate at dedicated-queue scale above PostgreSQL's practical limit
Pricing
The core Graphile Worker and OSS plans are free. Worker Pro is $25 a month on its launch offer or $100 a month at the regular price.
- Graphile WorkerFree and open-source · MIT licenseFree
- Graphile Worker OSSPostgreSQL-backed Node.js job queue · MIT licensed · self-hostedFree
- Worker Pro launch offerFrom $25+/mo USD via GitHub Sponsors · Early access · live migration · crashed worker recovery · proprietary source-available license$25/mo
- Worker Pro regular price$100 /month · Proprietary preset · regular price stated on launch offer page$100/mo
- Worker Pro regular pricingFrom $100/mo USD via GitHub Sponsors · Advanced quality-of-life features · proprietary source-available license$100/mo
- Private Advisor sponsorshipFrom $899/mo USD via GitHub Sponsors or bespoke invoicing · Worker Pro · development support contract · discounted consultancy$899/mo
As worker.graphile.org lists them, checked 8 Oct 2026.
Questions
Is Graphile Worker free?
Yes. Graphile Worker and Graphile Worker OSS are free, self-hosted plans released under the MIT license.
What does Graphile Worker require?
The current release depends on PostgreSQL 12 or later and Node.js 22.18 or later.
Can it run inside an application server?
Yes. It can operate standalone or run embedded in the application server's Node.js process.
Does it retry failed jobs?
Yes. Failed tasks are automatically scheduled again with progressively longer delays.
Can it schedule recurring jobs?
Yes. Cron-like schedules support recurring tasks, optional backfill, and distributed workers.
What is Worker Pro?
Worker Pro provides crashed-worker recovery and live migration to newer Worker versions. Its launch offer is $25 a month, with a regular price of $100 a month.