Configuration File

All CLI flags can be expressed as a YAML config file. Supports ${ENV_VAR} interpolation.

File Location

By default, Seedling looks for seedling.yaml in the current directory. Use --config to specify a different path:

seedling generate --config ./configs/staging.yaml

Full Reference

database:
  dsn: "${DATABASE_URL}"

output:
  format: sql
  file: seed.sql
  batch_size: 1000
  use_copy: true

generation:
  count: 50000
  seed: 42
  verbose: true
  parallel: false

schema:
  file: schema.yaml

generators:
  file: overrides.yaml

Sections

`database`

Field	Description	Example
`dsn`	Database connection string	`postgres://user:pass@localhost:5432/mydb`

`output`

Field	Description	Default
`format`	Output format (`sql`, `csv`, `jsonl`, `parquet`)	`sql`
`file`	Output file path	`seed.sql`
`batch_size`	Rows per batch	`1000`
`use_copy`	Use Postgres COPY protocol	`false`

`generation`

Field	Description	Default
`count`	Rows per root table	`100`
`seed`	Deterministic seed (0 = random)	`0`
`verbose`	Progress bars and summary	`false`
`parallel`	Generate tables in parallel	`false`

`schema`

Field	Description	Default
`file`	Schema file path	`schema.yaml`

`generators`

Field	Description
`file`	Generator overrides YAML file

Environment Variable Interpolation

database:
  dsn: "${DATABASE_URL}"

generation:
  seed: "${SEEDLING_SEED}"

Variables that are not set remain as literal strings (e.g., ${UNDEFINED_VAR} stays as-is).

​Configuration File

​File Location

​Full Reference

​Sections

​database

​output

​generation

​schema

​generators

​Environment Variable Interpolation