Skip to content
Grog Docs

Configuration

Grog is configured using a grog.toml file that is placed in the root of your workspace. Find below a complete example of a grog configuration file:

# Grog Configuration Example


# Workspace Settings
root = "/path/to/grog/root"


# Execution Settings
fail_fast = true # Exit immediately when encountering an issue
num_workers = 4


# Logging Settings
log_level = "info"


# Cache Settings
enable_cache = true # default


[cache]
backend = "s3"  # Options: "" (local), "gcs", "s3"


[cache.gcs]
bucket = "my-gcs-bucket"
prefix = "grog-cache/"
credentials_file = "/path/to/gcs-credentials.json"

All value in this file can be overridden at runtime by passing an environment variable of the same name prefixed with GROG_. For instance, to set or override the fail_fast option set GROG_FAIL_FAST=false.

Configuration Variables Explained

  • root: The base directory where Grog stores its internal files. Defaults to ~/.grog.
  • fail_fast: When true, Grog will stop execution after encountering the first error, cancelling all running tasks. Defaults to false.
  • num_workers: Number of concurrent workers for parallel task execution. Defaults to the number of CPUs.
  • log_level: Determines verbosity of logging (e.g., “debug”, “info”). Defaults to info.
  • enable_cache: Controls whether caching is enabled. Defaults to true.