Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Graphile Worker

worker.graphile.org

  • Free plan
  • Open source
  • Windows
  • macOS
  • Linux
  • API
  • Self-hosted

What Graphile Worker is

Graphile Worker stores jobs in PostgreSQL and runs them on Node.js, so background work need not hold up application responses. It supports standalone or embedded deployment, including running in the same Node.js process as an application server. Jobs run at least once; failures trigger automatic retries with exponential backoff. Recurring tasks can follow crontab-like schedules with optional backfill, and jobs can be de-duplicated using a unique job_key. Batch jobs can append data to jobs that are already enqueued. The feature list says execution typically starts in under 3ms using PostgreSQL LISTEN/NOTIFY. The current version requires PostgreSQL 12+ and Node 22.18+. Installation is available through npm, Yarn or pnpm, and global installation is not recommended. The connection documentation describes SSL-encrypted PostgreSQL connections and CA certificate configuration. Graphile Worker is free and open source under the MIT license. Worker Pro adds crashed-worker recovery and live migration to new versions. The maker describes it as a queue for regular organizations, not a replacement for dedicated queues at Facebook scale.

Who it suits

Graphile Worker suits developers who want a self-hosted job queue for Node.js applications using PostgreSQL. Its maker positions it for regular organizations rather than Facebook-scale workloads.

Good to know, and what to watch

  • Automatic retries use exponential backoff.
  • Recurring tasks support crontab-like schedules and optional backfill.
  • Jobs can be de-duplicated by unique job_key.
  • Can run embedded in an application server process.
  • Free and open source under the MIT license.
  • Requires PostgreSQL 12+ and Node 22.18+.
  • Self-hosted deployment requires a user-managed environment.
  • No dead-letter queue is listed.
  • Global installation is not recommended.

Graphile Worker

Free

Graphile Worker OSS

Free

Worker Pro launch offer

$25/mo

Worker Pro regular price

$100/mo

Open source

Getting started

  1. Open the Graphile Worker website
  2. Install the package with npm, Yarn, or pnpm
  3. Provide a PostgreSQL 12+ database
  4. Use Node.js 22.18+
  5. Run it standalone or in the application server process

Limits to check

The free Graphile Worker plan is free and includes the open-source MIT-licensed project. Worker Pro Launch Offer costs $25 a month, while the regular Worker Pro price is $100 a month; Pro adds crashed-worker recovery and live migration.

The Club's review

Overview

Graphile Worker is a background-job system for Node.js applications that use PostgreSQL. It is best suited to teams that want queue processing close to their database and are prepared to run the software themselves. Its appeal is a capable open-source core; its main compromises are self-hosting and the absence of a dead-letter queue.

Jobs are stored in PostgreSQL and processed by Node.js, so lengthy work can happen outside the request path. Workers may run separately or inside the application server’s Node.js process. The embedded option can fit an existing deployment, while standalone workers separate job processing from request handling. In both cases, the team operates the worker and database.

The project is pitched as a maintainable queue for regular organizations, not a substitute for dedicated queue infrastructure at Facebook scale. It pairs naturally with database-centered frameworks such as PostGraphile and PostgREST, and can suit applications already organized around PostgreSQL.

Key features

Retries and job controls

Jobs execute at least once, with automatic retries using exponential backoff when a job fails. Custom retry policies give teams room to adapt failure handling, but at-least-once execution means task code should be safe to run again. There is no dead-letter queue, which makes it a weaker fit for teams that need failed jobs isolated for later inspection or reprocessing.

A unique job_key can prevent duplicate tasks, and batch jobs can append data to an already queued job. These controls help consolidate repeated requests or accumulate related work before processing, without requiring a separate queue service.

Scheduling and responsiveness

Recurring tasks support crontab-like schedules, with optional backfill when scheduled runs need to be caught up. The feature list says execution typically starts in under 3ms through PostgreSQL LISTEN/NOTIFY, a useful design for responsive background work, though the stated timing is typical rather than a guarantee for every deployment.

Operations and security

Graphile Worker supports SSL-encrypted PostgreSQL connections and CA certificate configuration. The current version requires PostgreSQL 12 or later and Node 22.18 or later, requirements worth checking before adoption. Installation is supported through npm, Yarn, or pnpm; global installation is not recommended.

Community assistance is available through Graphile Discord, and the maker offers professional support contracts. Worker Pro adds crashed-worker recovery and live migration to new Worker versions, addressing operational concerns that the open-source core does not cover in the same way.

Pricing

The Graphile Worker core costs free and is open source under the MIT license. That is the practical starting point for teams able to host and maintain their own PostgreSQL-backed workers; it does not remove the operational work of running them.

Worker Pro’s launch offer costs $25 a month, billed from $25+ per month as sponsorship. It provides early access, a limited feature set, a proprietary preset, and sponsor access. This is for teams willing to sponsor the project and accept an early, limited offering in exchange for Pro access.

The stated regular Worker Pro price is $100 a month, billed monthly, for the proprietary preset. Teams needing crashed-worker recovery and live migration should weigh that paid tier against the free core; those features are the clearest reason to pay. The pricing terms provided do not establish seat or usage quotas, so the decision rests chiefly on the Pro capabilities and sponsorship terms.

Platforms

Graphile Worker is self-hosted and supports Linux, macOS, and Windows. Its API-oriented platform listing and JavaScript and TypeScript SDK language support reflect its fit for Node.js development rather than a managed, hosted queue. Teams must provide their own deployment and PostgreSQL environment.

Who it's for

Choose Graphile Worker if your application already depends on PostgreSQL, your background tasks run on Node.js, and you want scheduling, retries, and job controls without adding a separate queue platform. It is particularly suitable for database-centric application teams that value an open-source MIT core and can take responsibility for operations.

Look elsewhere if you need a hosted service, a dead-letter queue, or infrastructure designed for very large-scale dedicated queue workloads. The current PostgreSQL and Node.js minimums may also rule it out for teams maintaining older runtimes.

Pros and cons

  • PostgreSQL-backed and open source: the free MIT-licensed core keeps jobs alongside a database many target teams already operate.
  • Flexible job handling: exponential-backoff retries, custom retry policies, scheduling, de-duplication, and batch appends cover common queue needs.
  • Deployment choice: standalone and embedded modes let teams separate workers or run them in the application process.
  • Self-hosted responsibility: teams must operate the workers and PostgreSQL rather than rely on a hosted deployment.
  • No dead-letter queue: failed tasks cannot be routed into that queue pattern.
  • Pro operational features cost extra: crashed-worker recovery and live migration are Worker Pro additions, not part of the free core.

Alternatives

Task Queue Software is the broader category to explore if Graphile Worker’s PostgreSQL and Node.js focus does not match your stack.

Consider IronWorker if you want a freemium option with a free plan, free trial, and a public-cluster tier that specifies concurrency, runtime, memory, and scheduled-task limits. Faktory is another freemium choice, with an AGPL open-source tier and an enterprise option priced at $99 a month for additional packs.

Google Tasks is a free alternative for personal task lists, subtasks, due dates, and notifications across Android, iOS, and web. Hatchet may suit teams looking for a freemium platform with a pay-as-you-go plan that starts at $0 and includes monthly free run and event allowances.

JobRunr is a freemium alternative with a forever-free OSS tier that includes recurring jobs. River offers a free open-source tier with reliable background jobs and an intuitive web UI, but no workflows, concurrency limits, or support; its Pro tier is $125 a month.

Upstash QStash is worth considering for an API- and web-oriented alternative, with a free tier capped at 1,000 messages per day and a pay-as-you-go option priced at $1 a month per 100,000 messages. Hangfire is another freemium option, with an always-free Open tier covering Hangfire Core under LGPL 3.0 and SQL Server 2008 R2+ or in-memory storage.

Verdict

Graphile Worker is a strong choice for Node.js teams already using PostgreSQL that want a self-hosted queue with scheduling, retries, and useful job controls at no core software cost. Its main reason to choose it is that close fit with a PostgreSQL-backed application; its main reasons to look elsewhere are the operational burden, no dead-letter queue, and the paid gate on Worker Pro’s recovery and migration features.

The verdict

Graphile Worker offers scheduling, retries and job controls for PostgreSQL-backed Node.js applications. Check its version requirements and self-hosted model; Worker Pro adds crashed-worker recovery and live migration.

Questions people ask

Is Graphile Worker free?

Yes. The Graphile Worker plan is free and is free and open source under the MIT license.

Which platforms does it support?

Listed platforms are API, Linux, macOS, self-hosted, and Windows.

What database and runtime are required?

The current version requires PostgreSQL 12+ and Node 22.18+.

How can it be installed?

The package can be installed through npm, Yarn, or pnpm; global installation is not recommended.

Does it retry failed jobs?

Yes. Jobs execute at least once, and failures trigger automatic retries with exponential backoff.

What does Worker Pro add?

Worker Pro adds crashed-worker recovery and live migration to new Worker versions.

What the maker publishes

Automatic retries
Failed tasks are rescheduled with exponential backoff. source
Batch jobs
Array payloads can be accumulated and processed as batch jobs. source
Community activity
Good First Issue lists about 2,400 stars, 130 forks and four open beginner-friendly issues for the repository. source
Company facts
LinkedIn describes Graphile as a privately held open-source tooling company founded in 2018, headquartered in Southampton, with 2–10 employees. source
Container distribution
Docker Hub publishes the graphile/worker image and repeats PostgreSQL 10+ and Node 10+ as requirements for older releases. source
Database integrations
The maker says Graphile Worker pairs well with PostGraphile, PostgREST, and other database-centric application frameworks. source
Deployment modes
It supports standalone and embedded modes, including running in the same Node.js process as an application server. source
Docker
An official graphile/worker Docker image is available and accepts CLI options and mounted task directories. source
Documentation depth
The documentation includes installation, configuration, CLI, library, schema, TypeScript, SQL, cron, scaling, error handling, Docker and FAQ sections. source
Future scheduling
Jobs can be scheduled for a future time with the runAt or run_at APIs. source
Installation
The package can be installed through npm, Yarn, or pnpm; global installation is not recommended. source
Intended use
The maker describes Graphile Worker as a simple-to-maintain queue for regular organizations and says it is not intended to replace dedicated queues at Facebook scale. source
Job controls
The feature list includes task de-duplication by unique job_key and batch jobs that append data to already enqueued jobs. source
Job deduplication
jobKey and jobKeyMode support replacing, updating, debouncing or deduplicating queued jobs. source
Legal entity
A Companies House-derived company listing identifies Graphile Ltd with registration number 11171700 and a Hampshire registered address. source
License
The core Graphile Worker project is released under the MIT license. source
Limit: dedicated queues
An independent Reddit discussion describes Graphile Worker as less suitable than dedicated high-performance queues at very large scale. source
Limit: PostgreSQL dependence
The project is intended for teams already using PostgreSQL and Node.js, and its throughput falls when the database becomes the bottleneck. source
Low latency
The feature list says job execution typically starts in under 3ms, using PostgreSQL LISTEN/NOTIFY. source
Node API
The library exposes run, makeWorkerUtils, addJob, quickAddJob and event interfaces for embedding workers in Node applications. source
Open issue: local queue documentation
The issue tracker lists documentation for the local queue as an open task. source
Open issue: native ESM
The project issue tracker lists native ESM support as an open feature request. source
Package adoption
npm lists version 0.18.0, MIT licensing, 65 published versions, 33 dependents and about 624,751 weekly downloads. source
Parallel execution
Workers can process jobs concurrently, while named queues can serialize related jobs. source

Checked against the maker's pages on 15 Oct 2026.