Skip to main content
Durable Workflow provides a flexible configuration system that allows you to customize how workflows are stored, executed, and managed in your Laravel application.

Configuration File

The main configuration file is located at config/workflows.php. You can publish this configuration file using:
php artisan vendor:publish --provider="Workflow\Providers\WorkflowServiceProvider"

Key Configuration Areas

Workflows Folder

Defines where your workflow classes are stored in your application.
'workflows_folder' => 'Workflows',

Database Models

Customize the Eloquent models used for persisting workflow data:
  • stored_workflow_model - Main workflow instances
  • stored_workflow_exception_model - Workflow exceptions
  • stored_workflow_log_model - Activity execution logs
  • stored_workflow_signal_model - External signals
  • stored_workflow_timer_model - Scheduled timers

Serialization

Configure how workflow data is serialized and stored:
'serializer' => Workflow\Serializers\Y::class,

Data Retention

Control how long completed workflows are kept:
'prune_age' => '1 month',

Configuration Topics

Queue Configuration

Configure Laravel queues for workflow execution

Database Setup

Set up database tables and connections

Configuration Options

Complete reference of all configuration options

Environment Variables

Many configuration options can be overridden using environment variables:
WORKFLOW_WEBHOOKS_ROUTE=webhooks
WORKFLOW_WEBHOOKS_AUTH_METHOD=none
WORKFLOW_WEBHOOKS_SECRET=your-secret-key
See the Configuration Options page for a complete list of available environment variables.

Build docs developers (and LLMs) love