Configuration Reference

DBSprout is configured by a dbsprout.toml file, normally generated by dbsprout init. All keys are validated — unknown keys are rejected with a clear error.

Example

[schema]
dialect = "postgresql"
source = "postgresql://user:***@localhost:5432/mydb"
snapshot = ".dbsprout/snapshots/a1b2c3d4.json"

[generation]
default_rows = 100
seed = 42
engine = "heuristic"
output_format = "sql"
output_dir = "./seeds"

[privacy]
tier = "local"

# Per-table overrides
[tables.users]
rows = 50

[tables.audit_logs]
exclude = true

[schema]

Key	Type	Default	Notes
dialect	string	unset	SQL dialect (sqlite, postgresql, mysql, …)
source	string	unset	Connection URL or schema file path
snapshot	string	unset	Path to the stored schema snapshot

[generation]

Key	Type	Default	Notes
default_rows	int	100	Rows per table (≥ 1)
seed	int	42	Deterministic seed (≥ 0)
engine	string	heuristic	One of heuristic, spec, statistical, finetuned
output_format	string	sql	One of sql, csv, json, jsonl, parquet
output_dir	string	./seeds	Output directory for generated files

[privacy]

Key	Type	Default	Notes
tier	string	local	One of local, redacted, cloud

[tables.<name>]

Per-table overrides, keyed by table name.

Key	Type	Default	Notes
rows	int	unset	Override row count for this table
exclude	bool	false	Skip this table during generation

Cloud LLM provider/model settings and training options live in their own sections written by the relevant commands. Run dbsprout doctor to validate a config file, and see the LLM Configuration guide for provider setup.