Skip to main content

atmos devcontainer attach

Use this command to attach to a running devcontainer and get an interactive shell. If the container is not running, it will be started automatically.

atmos devcontainer attach --help

Usage​

atmos devcontainer attach <name> [flags]

Arguments​

name
Name of the devcontainer to attach to

Flags​

--instance string
Instance name for this devcontainer (default: default)

Examples​

# Attach to a devcontainer
atmos devcontainer attach geodesic

# Attach to a specific instance
atmos devcontainer attach terraform --instance project-a

Behavior​

  • Opens an interactive shell (/bin/bash by default) in the container
  • Uses login shell (-l flag) if userEnvProbe is set to loginShell or loginInteractiveShell in the devcontainer configuration
  • Automatically starts the container if it's not running
  • Inherits your terminal size and supports full TTY features

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. Exit the attached shell before running the cleanup commands.

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

See Also​