---
title: Using File Storage with the Scaleway CLI
description: This page lists basic commands to use Scaleway File Storage using the Scaleway Command Line Interface (CLI)
tags: cli command line interface terminal file 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 file systems 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 file system

The following command allows you to create a file system:

```bash
scw file filesystem create name=<NAME> size=<SIZE_IN_BYTES>
```

## Listing your file systems

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

```bash
scw file filesystem list
```

## Getting details on a file system

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

```bash
scw file filesystem get <FILE_SYSTEM_ID>
```

## Updating a file system

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

```bash
scw file filesystem update <FILE_SYSTEM_ID>
```

## Attaching a file system to an Instance

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

The following command allows you to attach a file system to an Instance:

```bash
scw instance server attach-filesystem server-id=<INSTANCE_ID> filesystem-id=<FILESYSTEM_ID>
```

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

## Detaching a file system from an Instance

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

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

```bash
scw instance server detach-filesystem server-id=<INSTANCE_ID> filesystem-id=<FILESYSTEM_ID>
```

## Deleting a file system

The following command allows you to delete a given file system:

```bash
scw file filesystem delete <FILE_SYSTEM_ID>
```

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