Skip to main content

Examples

Explore Atmos example projects with stack configurations, components, and workflows

ai

Use AI to chat with your infrastructure, inspect stacks and components, and analyze command output.

ai-claude-code

Use your Claude Pro/Max subscription instead of API tokens. Claude Code manages the AI

auth-stores

Demonstrates how stores authenticate using Atmos auth identities instead of the default credential chain.

aws-security-compliance

Analyze AWS security findings, map them to Atmos components and stacks, and get

config-profiles

This example demonstrates Atmos config profiles - a powerful feature for managing environment-specific configurations without duplicating settings across your infrastructure.
Stacks

demo-ansible

Minimal Atmos setup demonstrating how stack variables are passed to Ansible playbooks.
Automation

demo-atlantis

Generate Atlantis configuration for PR-based Terraform automation.
Automation

demo-auth

This demo showcases how to structure an Atmos project with an auth section in atmos.yaml. Please see the Atmos docs for more information.
Stacks

demo-component-versions

Pin components to specific versions for reproducible deployments.
Components

demo-context

Inspect how Atmos resolves configuration from multiple sources.
Stacks

demo-custom-command

Customize Atmos to run any command you want to make it easier for teams to use your toolchain.
Automation

demo-env

This example demonstrates how to use atmos env to export environment variables
Stacks

demo-helmfile

Deploy Kubernetes resources using Helmfile with Atmos stack patterns.
DX

demo-library

Here are some examples of distributing reusable components as part of a library.
Components

demo-localstack

When running Terraform with LocalStack, if you get the following warning from Terraform, you should not enable skip_requesting_account_id. Older versions of LocalStack required this, but not anymore...
DX

demo-schemas

Validate stack configuration against JSON Schema before running Terraform.
Stacks

demo-stacks

Inherit configuration across environments to eliminate duplication.
Stacks

demo-vendoring

Pull Terraform modules from GitHub, S3, or OCI registries with pinned versions.
Components

demo-workflows

Run multiple Atmos commands in sequence with a single command.
Automation

devcontainer

This example demonstrates how to configure devcontainers in Atmos as a replacement for the Geodesic shell wrapper.
DX

devcontainer-build

This example demonstrates using a custom Dockerfile with Atmos devcontainers. The Dockerfile extends the Geodesic base image and pre-installs Atmos.
DX

generate-files

This example demonstrates how to use atmos terraform generate files to generate an entire Terraform component from stack configuration.
Automation

locals

Reduce repetition and build computed values using file-scoped locals.

mcp

Connect Atmos to external MCP servers from the AWS ecosystem. Their tools become available

native-terraform

This example demonstrates migrating from native Terraform (with .tfvars files) to Atmos.

quick-start-advanced

Atmos is a universal tool for DevOps and cloud automation. It allows
Quickstart

quick-start-simple

Minimal Atmos setup with a single component and three environments.
Quickstart

secrets-masking

This example demonstrates Atmos's automatic secrets masking feature.

source-provisioning

Demonstrates JIT (Just-in-Time) source provisioning from both local and remote sources.
Components

stack-names

This example demonstrates imperative stack naming using the name field in stack manifests.
Stacks

toolchain

Configure tool registries and use toolchain-managed tools in custom commands and workflows.
DX

workflow-retries

Demonstrates automatic retry configuration for workflow steps.