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

# nsc volume release

Releases all volumes for a provided tag.

`volume release` destroys all volumes backing the provided volume tag.

## Usage

```bash theme={null}
nsc volume release <volume-tag>
```

### Example

<Steps titleSize="h4">
  <Step title="List cache volumes">
    List cache volumes to identify the tag to release:

    ```sh theme={null}
    % nsc volume list
    ```

    ```text nocopy Output theme={null}
    ┌───────────────────────────────────────────────────────────────────────┐
    │ Tag                            Size (Used / Total)   Last Used        │
    │───────────────────────────────────────────────────────────────────────│
    │ build-cluster-arm64            12 GiB / 64 GiB       22 hours ago     │
    │ build-cluster-amd64            8.0 GiB / 64 GiB      22 hours ago     │
    │ my-private-docker-image-cache  5.0 GiB / 20 GiB      1 month ago      │
    │ my-private-preview-cache       1.2 GiB / 20 GiB      1 month ago      │
    └───────────────────────────────────────────────────────────────────────┘
    ```
  </Step>

  <Step title="Release the cache volume">
    Release the cache volume tagged `my-private-preview-cache`:

    ```sh theme={null}
    % nsc volume release my-private-preview-cache
    ```

    ```text nocopy Output theme={null}
    Released volumes with tag my-private-preview-cache.
    ```
  </Step>

  <Step title="Verify the release">
    List the cache volumes again to verify the release:

    ```sh theme={null}
    % nsc volume list
    ```

    ```text nocopy Output theme={null}
    ┌───────────────────────────────────────────────────────────────────────┐
    │ Tag                            Size (Used / Total)   Last Used        │
    │───────────────────────────────────────────────────────────────────────│
    │ build-cluster-arm64            12 GiB / 64 GiB       22 hours ago     │
    │ build-cluster-amd64            8.0 GiB / 64 GiB      22 hours ago     │
    │ my-private-docker-image-cache  5.0 GiB / 20 GiB      1 month ago      │
    └───────────────────────────────────────────────────────────────────────┘
    ```
  </Step>
</Steps>