Notes

This example provisions an S3 bucket against a local AWS sandbox — no AWS account or credentials required. The sandbox is an Atmos emulator component: a stack-scoped container that Atmos starts and stops for you. By default it runs Floci, a free, MIT-licensed AWS emulator and a drop-in replacement for LocalStack Community Edition (which was EOL'd in March 2026).

The emulator is declared as a component (components.emulator.aws, driver floci/aws) and a single aws/emulator identity in atmos.yaml binds every Terraform component to it. The provider-config contributor injects the AWS provider settings (dummy credentials, path-style S3, skip-flags) automatically, so there is no providers.tf and no endpoint configuration to maintain, and no hand-rolled docker-compose.yml.

Usage

Start the sandbox, apply, then tear everything down (a container runtime — Docker or Podman — is the only prerequisite):

atmos emulator up aws -s dev          # start the local sandbox for the `dev` stack
atmos terraform apply demo -s dev     # provision the S3 bucket against the emulator
atmos terraform output demo -s dev    # inspect outputs

atmos terraform destroy demo -s dev   # remove the resources
atmos emulator down aws -s dev        # stop and remove the sandbox container

Other lifecycle verbs: atmos emulator ps aws -s dev (status) and atmos emulator logs aws -s dev.

The atmos test custom command runs the full apply/destroy lifecycle across the dev, staging, and prod stacks.