Skip to main content

atmos devcontainer list

Use this command to list all devcontainers configured in your Atmos project.

atmos devcontainer list --help

Usage​

atmos devcontainer list

This command displays all devcontainers defined in your atmos.yaml configuration along with their current status (running, stopped, or not created).

Output​

The command shows:

  • Name: The devcontainer name from your configuration
  • Status: Current state (running, stopped, or - if not created)
  • Runtime: Container runtime being used (docker or podman)
  • Image: The container image specified in the configuration

Examples​

# List all devcontainers
atmos devcontainer list

Example output:

NAME        STATUS    RUNTIME   IMAGE
geodesic    running   podman    cloudposse/geodesic:latest
terraform   stopped   podman    hashicorp/terraform:1.6
python      -         podman    python:3.11-slim

Try it out​

Copy the example into a new directory and make it your own:

atmos init examples/devcontainer
cd devcontainer

Install Docker or Podman, then inspect the configured development containers.

atmos devcontainer list
Explore the example →Initialization and repository settings

See Also​