Overview

pgflow’s configuration is divided into two distinct parts, each serving a different purpose in the workflow lifecycle.

pgflow separates configuration into task execution settings (how individual steps are executed and retried) and worker settings (how the worker processes the entire flow). Task settings are stored in your database and control retry behavior, delays, and timeouts, while worker settings control concurrency, connections, and batching.

Documentation Structure

This page provides an overview of pgflow configuration. Use the links below to access detailed documentation for each configuration area.

Step Execution Options Configure retry behavior, timeouts, and error handling for your workflow steps. Set defaults at flow level, override per step.

Worker Configuration Runtime settings for Edge Worker including concurrency, database connections, and polling behavior.

Zero Configuration

pgflow comes with sensible defaults for all configuration options.

You only need to specify slugs for your flow and steps:

new Flow({ slug: 'my_flow' })
  .step({ slug: 'step1' }, handler1)
  .step({ slug: 'step2' }, handler2)

Related Guides

Retrying Steps Configure retry policies for different step reliability requirements.

Delaying Steps Schedule steps to run after specified delays for multi-day workflows.

Tune Deployed Flows Adjust retry behavior and timeouts for production flows without recompiling.