Skip to main content

Configuration

Use a replay.yaml config file to set default configuration, define environment profiles, and create reusable presets.

Config File Location

Replay looks for a config file in the current working directory. It checks these names in order:
  1. replay.yaml
  2. replay.yml
  3. .replay.yaml
  4. .replay.yml
You can also specify a custom path with --config:

Config File Structure

Config Sections

Merge Order

When running a workflow, config values are merged in this order (later overrides earlier):
  1. Config file default (config section)
  2. Selected profile (profiles.<name>.config)
  3. Presets listed in vars.presets
  4. Workflow file’s own config section

Environment Variable Interpolation

Config values support {{ VAR }} template syntax:
Environment variables are loaded into the global scope at startup.

What’s Next?