---
title: Using Block Storage with the Scaleway CLI
description: This page lists basic commands to use Scaleway Block Storage using the Scaleway command line interface (CLI)
tags: cli command line interface terminal block storage system
dates:
  validation: 2026-01-29
  posted: 2026-01-29
---
import Requirements from '@macros/iam/requirements.mdx'

This page contains basic commands to manage your Block Storage volumes using the Scaleway CLI. 

<Requirements />

- A Scaleway account logged into the [console](https://console.scaleway.com)
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
- [Installed and configured](/scaleway-cli/quickstart/) the Scaleway CLI

## Creating a volume

The following command allows you to create a volume:

```bash
scw block volume create name=<NAME> size=<SIZE_IN_GB>
```

## Listing your volumes

The following command allows you to list volumes present in your Organization:

```bash
scw block volume list
```

## Getting details on a volume

The following command allows you to get information about a given volume:

```bash
scw block volume get <VOLUME_ID>
```

## Updating a volume

The following command allows you to modify the settings of a volume:

```bash
scw block volume update <VOLUME_ID>
```

## Attaching a volume to an Instance

<Message type="note">
Attaching a volume to an Instance must be done using the Instances CLI. Refer to the [dedicated documentation](https://cli.scaleway.com/instance/#attach-a-volume-to-an-instance) for more information.
</Message>

The following command allows you to attach a volume to an Instance:

```bash
scw instance server attach-volume server-id=<INSTANCE_ID> volume-id=<VOLUME_ID> volume-type=<VOLUME_TYPE>
```

Once your volume is attached to the desired Instance, you must mount it from within the Instance to use it. Refer to the [dedicated documentation](/block-storage/how-to/mount-a-volume/) for more information.

## Detaching a volume from an Instance

<Message type="note">
Detaching a volume from an Instance must be done using the Instances CLI. Refer to the [dedicated documentation](https://cli.scaleway.com/instance/#detach-a-volume-from-an-instance) for more information.
</Message>

The following command allows you to detach a volume from an Instance:

```bash
scw instance server detach-volume server-id=<INSTANCE_ID> volume-id=<VOLUME_ID>
```

## Deleting a volume

The following command allows you to delete a given volume:

```bash
scw block volume delete <VOLUME_ID>
```

For comprehensive information on the different CLI commands to interact with Scaleway Block Storage (including the different arguments for each command), refer to the [dedicated Scaleway CLI documentation](https://cli.scaleway.com/block/).