# atmos devcontainer stop

Use this command to stop a running devcontainer. The container is not removed, so you can start it again later.

## Usage

```shell
atmos devcontainer stop <name> [flags]
```

## Arguments

- **`name`** — Name of the devcontainer to stop

## Flags

- **`--instance string`** — Instance name for this devcontainer (default: `default`)
- **`--timeout int`** — Timeout in seconds to wait for container to stop (default: `10`)

## Examples

```shell
# Stop a devcontainer
atmos devcontainer stop geodesic

# Stop with custom timeout
atmos devcontainer stop geodesic --timeout 30

# Stop a specific instance
atmos devcontainer stop terraform --instance project-a
```

## Try it out

### devcontainer

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

```shell
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.

```shell
atmos devcontainer start geodesic
atmos devcontainer stop geodesic
atmos devcontainer remove geodesic
```

- [Installation guide](/install)
- [Explore the example](/examples/devcontainer)
- [Initialization and repository settings](/cli/commands/init#examples-and-source-directories)

## See Also

- [`atmos devcontainer start`](/cli/commands/devcontainer/start)
- [`atmos devcontainer remove`](/cli/commands/devcontainer/remove)