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

# dome sandbox

> Provision sandbox environments for development and testing

## Provision

`dome sandbox provision`

Provision a sandbox environment.

```bash theme={"system"}
# Create a sandbox workspace in the current tenant
dome sandbox provision --scope=workspace

# Create an isolated sandbox tenant with workspace and API key
dome sandbox provision --scope=tenant
```

| Flag               | Type   | Required | Description                                               |
| ------------------ | ------ | -------- | --------------------------------------------------------- |
| `--scope`          | string | Yes      | Scope: `tenant` or `workspace`                            |
| `--tenant-name`    | string | No       | Sandbox tenant name suffix (auto-generated if omitted)    |
| `--workspace-name` | string | No       | Sandbox workspace name suffix (auto-generated if omitted) |

### Scope Options

* **`workspace`** — creates a sandbox workspace in the current tenant. Requires tenant admin, operator, or security role.
* **`tenant`** — creates an isolated sandbox tenant with a workspace and API key. Requires org admin or owner role.