Atmos Project Configuration (atmos.yaml)

The atmos.yaml file is the central project configuration for Atmos. It defines how Atmos discovers stacks, where components live, how templates are processed, and how every subsystem (auth, stores, workflows, toolchain, validation, integrations) is configured. Every Atmos project needs at least one atmos.yaml.

Configuration Discovery

Atmos searches for atmos.yaml in this order (first found wins):

1. --config CLI flag or ATMOS_CLI_CONFIG_PATH environment variable.
2. Active profile (--profile flag or ATMOS_PROFILE environment variable).
3. Current working directory (./atmos.yaml).
4. Git repository root (<repo-root>/atmos.yaml).
5. Parent directory walk (searches upward until found).
6. Home directory (~/.atmos/atmos.yaml).
7. System directory (/usr/local/etc/atmos/atmos.yaml on Linux/macOS, %LOCALAPPDATA%/atmos/atmos.yaml on Windows).

When multiple files are found, they are deep-merged with earlier sources taking precedence.