# atmos devcontainer remove

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

## Usage

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

```shell
# 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)

## See Also

- [`atmos devcontainer stop`](/cli/commands/devcontainer/stop)
- [`atmos devcontainer rebuild`](/cli/commands/devcontainer/rebuild)