Skip to content

feat(FIL): add file storage documentation MTA-6218 #5178

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 3 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 52 additions & 0 deletions pages/file-storage/concepts.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
---
meta:
title: File Storage - Concepts
description: Explore essential concepts of File Storage.
content:
h1: File Storage - Concepts
paragraph: Explore essential concepts of File Storage.
tags: file storage file system concept glossary terms definitions
dates:
validation: 2025-06-25
posted: 2025-06-25
categories:
- file-storage
- storage
---

## Attach

Attaching storage to your Scaleway Instance enables you to use additional or shared storage beyond its [Local Storage](/local-storage/).

## Availability Zone

<Macro id="availability-zone" />

## Block volumes

<Macro id="block-volumes" />

## File Storage

Scaleway File Storage allows you to keep data in an organized hierarchy of files and folders. This hierarchy can be shared across a network, so multiple compute instances can work on the same collection of files.

## File system

A file system provides a structured way to manage files and directories in the cloud, so that Instances can access, read, and write data as if it were on a local disk. File systems can be shared by several [Instances](/instances/).

## IOPS

IOPS or Input/Ouptut Operations Per Second, is a unit of measurement that indicates how many read/write operations a storage device is performing per second.

Scaleway File Storage offers two IOPS limits:

- 5 000 IOPS (5K IOPS)
- 15 000 IOPS (15K IOPS)

## Mount

Mounting a storage volume allows you you to assign a directory (mount point) to an [attached](#attach) storage volume. The files on that storage become available via the assigned directory. This allows you to read and write files on the storage as if they were part of your local file system.

## Region

<Macro id="region" />
16 changes: 16 additions & 0 deletions pages/file-storage/faq.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
meta:
title: File Storage
description: Explore Scaleway File Storage with our comprehensive FAQ covering performance, persistence, and more.
content:
h1: File Storage FAQ
dates:
created: 2025-06-25
validation: 2025-06-25
category: storage
productIcon: FileStorageProductIcon
---

## What is Scaleway File Storage?

Scaleway File Storage allows you to keep data in an organized hierarchy of files and folders. This hierarchy can be shared across a network, so multiple compute instances can work on the same collection of files.
15 changes: 15 additions & 0 deletions pages/file-storage/how-to/attach-file-system.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
meta:
title: &title How to attach a file system to a Scaleway Instance
description: &description This page explains how to attach a File Storage file system to Scaleway Instances
content:
h1: *title
paragraph: *description
tags: attach instance server fs filesystem file storage resource
categories:
- storage
- file-storage
dates:
validation: 2025-06-24
posted: 2025-06-24
---
16 changes: 16 additions & 0 deletions pages/file-storage/how-to/create-file-system.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
meta:
title: &title How to create a file system
description: &description This page explains how to create a File Storage file system using the Scaleway console.
content:
h1: *title
paragraph: *description
tags: create add deploy fs filesystem file storage resource
categories:
- storage
- file-storage
dates:
validation: 2025-06-24
posted: 2025-06-24
---

15 changes: 15 additions & 0 deletions pages/file-storage/how-to/delete-file-system.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
meta:
title: &title How to delete a file system
description: &description This page explains how to delete a File Storage file system using the Scaleway console.
content:
h1: *title
paragraph: *description
tags: delete suppress cancel remove fs filesystem file storage resource
categories:
- storage
- file-storage
dates:
validation: 2025-06-24
posted: 2025-06-24
---
15 changes: 15 additions & 0 deletions pages/file-storage/how-to/detach-file-system.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
meta:
title: &title How to detach a file system from a Scaleway Instance
description: &description This page explains how to detach a File Storage file system from Scaleway Instances
content:
h1: *title
paragraph: *description
tags: detach instance server fs filesystem file storage resource
categories:
- storage
- file-storage
dates:
validation: 2025-06-24
posted: 2025-06-24
---
8 changes: 8 additions & 0 deletions pages/file-storage/how-to/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
meta:
title: File Storage - How Tos
description: File Storage How Tos
content:
h1: File Storage - How Tos
paragraph: File Storage How Tos
---
15 changes: 15 additions & 0 deletions pages/file-storage/how-to/manage-file-system.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
meta:
title: &title How to manage a file system
description: &description This page explains how to manage a File Storage file system using the Scaleway console.
content:
h1: *title
paragraph: *description
tags: manage update settings fs filesystem file storage resource
categories:
- storage
- file-storage
dates:
validation: 2025-06-24
posted: 2025-06-24
---
15 changes: 15 additions & 0 deletions pages/file-storage/how-to/mount-file-system.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
meta:
title: &title How to mount a file system on a Scaleway Instance
description: &description This page explains how to mount a File Storage file system on Scaleway Instances using the Scaleway console
content:
h1: *title
paragraph: *description
tags: mount instance server fs filesystem file storage resource
categories:
- storage
- file-storage
dates:
validation: 2025-06-24
posted: 2025-06-24
---
15 changes: 15 additions & 0 deletions pages/file-storage/how-to/unmount-file-system.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
meta:
title: &title How to unmount a file system from a Scaleway Instance
description: &description This page explains how to unmount a File Storage file system from Scaleway Instances using the Scaleway console
content:
h1: *title
paragraph: *description
tags: unmount instance server fs filesystem file storage resource
categories:
- storage
- file-storage
dates:
validation: 2025-06-24
posted: 2025-06-24
---
62 changes: 62 additions & 0 deletions pages/file-storage/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
---
meta:
title: File Storage Documentation
description: Explore Scaleway File Storage with quickstart guides, how-tos, and more.
---


<ProductHeader
productName="File Storage"
productLogo="fileStorage"
description="File Storage offers fast, reliable, and shareable file systems for Scaleway Instances."
url="/file-storage/quickstart/"
label="File Storage Quickstart"
/>

## Getting Started

<Grid>
<SummaryCard
title="Quickstart"
icon="rocket"
description="Learn to create File Storage volumes, attach, and mount them to a Scaleway Instance in a few easy steps."
label="View Quickstart"
url="/file-storage/quickstart/"
/>
<SummaryCard
title="Concepts"
icon="info"
description="Master core concepts for a deeper understanding of File Storage."
label="View Concepts"
url="/file-storage/concepts/"
/>
<SummaryCard
title="How-Tos"
icon="help-circle-outline"
description="Learn to use File Storage through the Scaleway console."
label="View How-Tos"
url="/file-storage/how-to/"
/>
<SummaryCard
title="Additional Content"
icon="book-open-outline"
description="Go further with detailed, in-depth information on File Storage."
label="View Additional Content"
url="/file-storage/reference-content/"
/>
</Grid>

<ClickableBanner
productLogo="cli"
title="File Storage API"
description="Manage File Storage using the Scaleway API."
url="https://www.scaleway.com/en/developers/api/file/"
label="Go to File Storage API"
/>

## Changelog

<ChangelogList
productName="file-storage"
numberOfChanges={3}
/>
15 changes: 15 additions & 0 deletions pages/file-storage/quickstart.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
meta:
title: File Storage - Quickstart
description: Get started with Scaleway File Storage. This guide covers creating, attaching, and mounting File systems to your Instances for efficient data management.
content:
h1: File Storage - Quickstart
paragraph: Get started with Scaleway File Storage. This guide covers creating, attaching, and mounting File Storagefile systems to your Instances for efficient data management.
tags: file storage overview get started
dates:
validation: 2025-06-24
posted: 2025-06-24
categories:
- file-storage
- storage
---
Loading