Skip to main content

atmos devcontainer rebuild

Use this command to rebuild a devcontainer from scratch. This stops and removes the existing container, pulls the latest image, and creates a new container.

atmos devcontainer rebuild --help

Usage​

atmos devcontainer rebuild <name> [flags]

Arguments​

name
Name of the devcontainer to rebuild

Flags​

--instance string
Instance name for this devcontainer (default: default)
--attach
Attach to the container after rebuilding
--no-pull
Don't pull the latest image before rebuilding

Examples​

# Rebuild a devcontainer
atmos devcontainer rebuild geodesic

# Rebuild and attach
atmos devcontainer rebuild geodesic --attach

# Rebuild without pulling latest image
atmos devcontainer rebuild geodesic --no-pull

# Rebuild a specific instance
atmos devcontainer rebuild terraform --instance project-a

Behavior​

  1. Stops the container if it's running
  2. Removes the existing container
  3. Pulls the latest image (unless --no-pull is specified)
  4. Creates a new container with the current configuration
  5. Starts the new container
  6. Optionally attaches to the container (if --attach is specified)

Use Cases​

  • Configuration changes: After updating your devcontainer.json or atmos.yaml
  • Image updates: To get the latest version of the base image
  • Clean slate: When you want to start fresh without any accumulated state

See Also​