How to attach a file system to a Scaleway Instance

Reviewed on October 30, 2025

This page explains how to attach a file system to one or several Instances. File systems can only be attached to Instances within the same region.

Before you start

To complete the actions presented below, you must have:

• A Scaleway account logged into the console
• Owner status or IAM permissions allowing you to perform actions in the intended Organization
• Created a file system
• Created at least one POP2 Instance

How to attach a file system using the Scaleway console

1. Click File Storage in the Storage section of the side menu. A list of your file systems displays.

2. Click the name of the file system you want to attach. The Overview page displays.

3. Open the Attached Instance(s). A list of currently attached Instances displays.

4. Click Attach an Instance. A pop-up displays.

5. Select one Instance or more from the drop-down list, then click Attach to confirm.

   Important

   File systems can only be attached to POP2 Instances within the same region.

Your file system is now attached to the selected Instance(s) and can now be mounted to a Scaleway Instance.

How to attach a file system using the API

The Scaleway API allows you to create and manage all your resources programmatically.

1. Make sure you have authenticated and performed your first request with the Scaleway API.

2. Run the cURL request below to attach your file system to the desired Instance. Remember to replace the placeholders with the appropriate values.

   curl -X POST 'https://api.scaleway.com/instance/v1/zones/<region>/servers/<instance-id>/attach-filesystem' \
     -H "X-Auth-Token: $SCW_SECRET_KEY" \
     -H "Content-Type: application/json" \
     -d '{"filesystem_id": "<my-fs-id>"}'

Refer to the Scaleway API documentation for more information on the different parameters.

How to attach a file system using the CLI

Scaleway CLI is a tool to help you pilot your Scaleway infrastructure directly from your terminal.

1. Make sure you have installed and configured the Scaleway CLI.

2. Run the command below to attach your file system to the desired Instance. Remember to replace the placeholders with the appropriate values.

   scw instance server attach-filesystem server-id=<instance_id> filesystem-id=<filesystem_id> zone=<availability_zone>

Refer to the Scaleway CLI documentation for more information on the different parameters.