> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trycassian.com/llms.txt
> Use this file to discover all available pages before exploring further.

# cassian down

> Stop a running instance.

## Usage

```bash theme={null}
cassian down [name] [options]
```

Saves your workspace to cloud, then stops the instance and releases the GPU.

## Options

| Flag          | Description                                                             |
| ------------- | ----------------------------------------------------------------------- |
| `-f, --force` | Exit immediately after sending the stop request — don't wait to confirm |

## Arguments

| Arg      | Description                                                   |
| -------- | ------------------------------------------------------------- |
| `<name>` | Instance name (optional — defaults to name in `cassian.yaml`) |

## Confirmation polling

By default, `cassian down` waits up to 30 seconds to confirm the instance actually stopped before returning. This makes it reliable in scripts.

Use `--force` to skip waiting:

```bash theme={null}
cassian down --force
cassian down my-instance --force
```

Useful in CI pipelines or cleanup scripts where you don't need to block on confirmation.

## What gets saved

* Everything in `/workspace` (code, scripts, outputs)
* Folders listed under `workspace.no_sync`

Not saved: pip packages, installed system packages, anything in `workspace.exclude`.

## Data safety

Your workspace is saved before the container stops. If the save fails, the instance stays running and you get an error rather than losing data.

## Billing

Billing stops as soon as the instance stops. You are not charged while the instance is off.