Skip to main content

atmos stack validate

Validate all stack manifest configurations against the atmos-manifest JSON Schema — the same one atmos stack schema prints. This is an alias for atmos validate stacks.

atmos stack validate --help
 

Usage

atmos stack validate

Examples

# Validate all stack manifests.
atmos stack validate

# Equivalent long form.
atmos validate stacks

# Validate against a custom schema.
atmos stack validate --schemas-atmos-manifest schemas/atmos-manifest.json

# Skip validation when no stack or Atmos configuration inputs changed.
atmos stack validate --affected --base origin/main
atmos stack validate --exclude 'stacks/experimental/**'

--affected resolves the Git merge-base automatically on GitHub Actions. A relevant stack or Atmos configuration change runs the complete stack validation, so imports and duplicate-component checks remain correct; unrelated changes are skipped. Use --base to select a local comparison point.

Use repeatable --exclude <glob> to omit stack manifests from full or affected validation.

Flags

--schemas-atmos-manifest (optional)
Path or URL of a JSON Schema to validate stack manifests against, overriding the embedded schema and any schemas.atmos.manifest setting.
--affected (optional)
Validate only when stack or Atmos configuration inputs changed since the Git merge-base.
--base (optional)
Git ref or SHA used as the comparison baseline for --affected.