It's all .stagefreight.yml

StageFreight is configured through one file at the repo root: .stagefreight.yml. There is no other config surface — no per-command flags to memorize, no scattered dotfiles. Every capability on this site maps to keys in that one file.

This section is the complete key reference, grouped by concern. Each page lists the keys it owns, the values they accept, and an annotated YAML block generated directly from the code — so the options shown here can never drift from what the binary actually parses.

Happy path vs. every knob

New here? Start with Quick Start — real, running configs you can copy. Come to Configuration when you need a specific knob and want to know whether it exists yet and what it accepts.

The buckets

Every top-level key, sorted into meaningful groups:

Section	Top-level keys it covers
Identity & Connectivity	version · vars · defaults · forges · repos · registries
Builds & Tests	builds · build_cache · test
Targets	targets (per-kind: registry · docker-readme · gitlab-component · release · binary-archive · generic-package · pages)
Narrate	narrate
Lint	lint
Policy	matchers · ci · versioning · dependency · release · security · commit · toolchains · glossary · presentation · tag · manifest
Lifecycle Modes	lifecycle · gitops · governance · docker
Signing	signing · signing_profiles

For the raw, exhaustive dump see the Full Schema Reference (generated). This section is the curated, explained version of the same thing.