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

# Storage Commands

> CLI reference for storage management

Manage storage volumes with the `tp storage` command group.

## Commands

* `tp storage create` - Create a new storage volume
* `tp storage list` (`ls`) - List storage volumes
* `tp storage info` - Get detailed information about a storage volume
* `tp storage edit` - Edit storage volume properties
* `tp storage destroy` (`rm`) - Delete a storage volume

<Note>
  To attach or detach storage volumes from clusters, use `tp cluster attach` and `tp cluster detach`. See [Cluster Commands](/cli/cluster-commands).
</Note>

***

## tp storage create

Create a new storage volume.

```bash theme={null}
tp storage create <size> [--name NAME] [--deletion-protection] [--wait]
```

**Arguments:**

* `size` - Size of the volume in GB (required, positional)
* `--name NAME` - Custom volume name (optional)
* `--deletion-protection` - Enable deletion protection (optional)
* `--wait` - Wait for the storage volume to be fully created (optional)

**Examples:**

```bash theme={null}
# Create a 500GB storage volume with a custom name
tp storage create 500 --name training-data

# Create a volume with deletion protection and wait for it to be ready
tp storage create 1000 --name important-data --deletion-protection --wait
```

***

## tp storage list

List your storage volumes. Alias: `tp storage ls`.

```bash theme={null}
tp storage list [--org]
```

**Arguments:**

* `--org, --organization` - List all volumes in your organization (optional)

**Examples:**

```bash theme={null}
# List your volumes
tp storage list

# List all organization volumes
tp storage ls --org
```

***

## tp storage info

Get detailed information about a storage volume.

```bash theme={null}
tp storage info <storage_id>
```

**Arguments:**

* `storage_id` - The ID of the storage volume to inspect

**Example:**

```bash theme={null}
tp storage info s-abc123
```

***

## tp storage edit

Edit storage volume properties.

```bash theme={null}
tp storage edit <storage_id> [options]
```

**Arguments:**

* `storage_id` - The ID of the storage volume to edit

**Optional Arguments:**

* `--name NAME` - New name for the storage volume
* `--deletion-protection DELETION_PROTECTION` - Enable/disable deletion protection (`true`/`false`)
* `-s, --size SIZE` - New size for the storage volume in GB (size can only be increased)

**Examples:**

```bash theme={null}
tp storage edit s-abc123 --name "new-volume-name"
tp storage edit s-abc123 --deletion-protection true
tp storage edit s-abc123 -s 2000
```

***

## tp storage destroy

Delete a storage volume permanently. Alias: `tp storage rm`.

```bash theme={null}
tp storage destroy <storage_id> [--no-input] [--wait]
```

**Arguments:**

* `storage_id` - ID of the storage volume to destroy
* `--no-input` - Skip confirmation prompts and destroy immediately (optional)
* `--wait` - Wait for the storage volume to be fully destroyed (optional)

**Examples:**

```bash theme={null}
# Destroy a storage volume (will prompt for confirmation)
tp storage destroy s-abc123

# Destroy without confirmation prompt
tp storage rm s-abc123 --no-input

# Destroy and wait for completion
tp storage destroy s-abc123 --wait
```

<Warning>
  This action is irreversible. Back up important data before destroying a volume.
</Warning>

***

## Workflow Example

```bash theme={null}
# 1. Create a 1TB storage volume
tp storage create 1000 --name shared-datasets --wait

# 2. Attach to a cluster (see tp cluster attach)
tp cluster attach c-xyz789 s-abc123

# 3. Detach from the cluster (see tp cluster detach)
tp cluster detach c-xyz789 s-abc123

# 4. Destroy when done
tp storage destroy s-abc123
```

## Next Steps

* [Storage Overview](/features/storage)
* [Best Practices](/guides/best-practices)