Skip to main content

atmos devcontainer remove

Use this command to permanently remove a devcontainer. This stops the container if it's running and deletes it.

atmos devcontainer remove --help

Usage​

atmos devcontainer remove <name> [flags]

Arguments​

name
Name of the devcontainer to remove

Flags​

--instance string
Instance name for this devcontainer (default: default)
--force / -f
Force removal even if the container is running

Examples​

# Remove a devcontainer
atmos devcontainer remove geodesic

# Force remove a running devcontainer
atmos devcontainer remove geodesic --force

# Remove a specific instance
atmos devcontainer remove terraform --instance project-a

Behavior​

  • Stops the container if it's running (or immediately if --force is used)
  • Removes the container and its associated data
  • Does not remove the container image (use docker rmi or podman rmi separately if needed)
  • Does not remove named volumes (use docker volume rm or podman volume rm separately if needed)

Try it out​

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

atmos init examples/devcontainer
cd devcontainer

Requires a running Podman runtime (the example selects Podman) and network access for the image. The final commands clean up the local container.

atmos devcontainer start geodesic
atmos devcontainer remove geodesic
Explore the example →Initialization and repository settings

See Also​