Skip to content

Commit 5f13139

Browse files
committed
docs(fls): update
1 parent 63b020d commit 5f13139

File tree

6 files changed

+152
-31
lines changed

6 files changed

+152
-31
lines changed

menu/navigation.json

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4934,6 +4934,62 @@
49344934
"label": "Block Storage",
49354935
"slug": "block-storage"
49364936
},
4937+
{
4938+
"items": [
4939+
{
4940+
"label": "Overview",
4941+
"slug": "../file-storage"
4942+
},
4943+
{
4944+
"label": "Concepts",
4945+
"slug": "concepts"
4946+
},
4947+
{
4948+
"label": "Quickstart",
4949+
"slug": "quickstart"
4950+
},
4951+
{
4952+
"label": "FAQ",
4953+
"slug": "faq"
4954+
},
4955+
{
4956+
"items": [
4957+
{
4958+
"label": "Create a file system",
4959+
"slug": "create-file-system"
4960+
},
4961+
{
4962+
"label": "Attach a file system",
4963+
"slug": "attach-file-system"
4964+
},
4965+
{
4966+
"label": "Mount a file system to an Instance",
4967+
"slug": "mount-file-system"
4968+
},
4969+
{
4970+
"label": "Manage and delete a file system",
4971+
"slug": "manage-delete-file-system"
4972+
},
4973+
{
4974+
"label": "Resize a file system",
4975+
"slug": "resize-file-system"
4976+
},
4977+
{
4978+
"label": "Unmount a file system from an Instance",
4979+
"slug": "unmount-file-system"
4980+
},
4981+
{
4982+
"label": "Detach a file system",
4983+
"slug": "detach-file-system"
4984+
}
4985+
],
4986+
"label": "How to",
4987+
"slug": "how-to"
4988+
}
4989+
],
4990+
"label": "File Storage",
4991+
"slug": "file-storage"
4992+
},
49374993
{
49384994
"items": [
49394995
{

pages/file-storage/concepts.mdx

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,24 +3,28 @@ title: File Storage - Concepts
33
description: Explore essential concepts of File Storage.
44
tags: file storage file system concept glossary terms definitions
55
dates:
6-
validation: 2025-06-25
7-
posted: 2025-06-25
6+
validation: 2025-07-23
7+
posted: 2025-07-23
88
categories:
99
- file-storage
1010
- storage
1111
---
1212

13+
import AvailabilityZone from '@macros/concepts/availability-zone.mdx'
14+
import BlockVolumes from '@macros/concepts/block-volumes.mdx'
15+
import Region from '@macros/concepts/region.mdx'
16+
1317
## Attach
1418

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

1721
## Availability Zone
1822

19-
<Macro id="availability-zone" />
23+
<AvailabilityZone />
2024

2125
## Block volumes
2226

23-
<Macro id="block-volumes" />
27+
<BlockVolumes />
2428

2529
## File Storage
2630

@@ -45,4 +49,4 @@ Mounting a storage volume allows you you to assign a directory (mount point) to
4549

4650
## Region
4751

48-
<Macro id="region" />
52+
<Region />

pages/file-storage/how-to/create-file-system.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,9 +23,9 @@ This page explains how to create a file system using the Scaleway console.
2323
2. Click **+ Create File system**. The [file system creation page](https://console.scaleway.com//file-storage/file-storage/create) displays.
2424

2525
3. Complete the following steps:
26-
- Select the region in which your file system will be created. It will be accessible by [Instances](/instances/) within the same [region](/file-storage/concepts/#region).
27-
- Enter a name for your file system, or use the automatically generated one. The name of your file system can only contain alphanumeric characters, spaces, and dashes.
28-
- Enter a size for your file system. Billing is based on the size provisioned here, and not actual usage.
26+
- Select the region in which your file system will be created. It will be accessible by [Instances](/instances/) within the same [region](/file-storage/concepts/#region).
27+
- Enter a name for your file system, or use the automatically generated one. The name of your file system can only contain alphanumeric characters, spaces, and dashes.
28+
- Enter a size for your file system. Billing is based on the size provisioned here, and not actual usage.
2929

3030
4. Review the estimated cost, then click **Create file system**.
3131

pages/file-storage/how-to/manage-delete-file-system.mdx

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -27,10 +27,10 @@ This page explains how to manage and delete a file system.
2727
2. Click the name of the file system you want to manage. The **Overview** page displays.
2828

2929
3. From this page, you can:
30-
- Resize your file system
31-
- Attach your file system to one or several Instance(s)
32-
- Retrieve the command to mount your file system on your Instance(s)
33-
- Delete your file system
30+
- Resize your file system
31+
- Attach your file system to one or several Instance(s)
32+
- Retrieve the command to mount your file system on your Instance(s)
33+
- Delete your file system
3434

3535
## How to delete a file system
3636

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
---
2+
title: How to resize a file system
3+
description: This page explains how to resize a File Storage file system using the Scaleway console
4+
tags: resize reduce increase size augment bigger smaller fs filesystem file storage disk space
5+
categories:
6+
- storage
7+
- file-storage
8+
dates:
9+
validation: 2025-07-23
10+
posted: 2025-07-23
11+
---
12+
13+
This page explains how to resize a file system using the Scaleway console.
14+
15+
import Requirements from '@macros/iam/requirements.mdx'
16+
17+
<Requirements />
18+
19+
- A Scaleway account logged into the [console](https://console.scaleway.com)
20+
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
21+
- [Created a file system](/file-system/how-to/create-file-system/)
22+
23+
1. Click **File Storage** in the **Storage** section of the side menu. A list of your file systems displays.
24+
25+
2. Click the name of the file system you want to resize. The **Overview** page displays.
26+
27+
3. Click the **Resize** button. A pop-up displays.
28+
29+
4. Enter a new size for your file system.
30+
<Message type="important">
31+
- New file system size cannot be inferior to the currently used space.
32+
- File system size must be at least 100 GB.
33+
- File system size can only be resized by increments of 100 GB.
34+
</Message>
35+
36+
5. Review the updated estimated cost. File Storage billing is based on the provisioned file storage size, and not on actual usage.
37+
38+
6. Click **Resize file system** to confirm.
39+
40+
Your file system is resized, and its new capacity displays in the **Overview** page.
41+
42+
<Message type="note">
43+
You can also resize a file system from the [File Storage section](https://console.scaleway.com/file-storage/) of the console, by clicking <Icon name="more" /> next to its name, and by selecting **Resize** from the drop-down menu.
44+
</Message>

pages/file-storage/quickstart.mdx

Lines changed: 36 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,22 @@
11
---
2-
meta:
3-
title: File Storage - Quickstart
4-
description: Get started with Scaleway File Storage. This guide covers creating, attaching, and mounting File systems to your Instances for efficient data management.
5-
content:
6-
h1: File Storage - Quickstart
7-
paragraph: Get started with Scaleway File Storage. This guide covers creating, attaching, and mounting File Storagefile systems to your Instances for efficient data management.
2+
title: File Storage - Quickstart
3+
description: Get started with Scaleway File Storage. This guide covers creating, attaching, and mounting File systems to your Instances for efficient data management.
84
tags: file storage overview get started
95
dates:
10-
validation: 2025-06-24
11-
posted: 2025-06-24
6+
validation: 2025-07-23
7+
posted: 2025-07-23
128
categories:
139
- file-storage
1410
- storage
1511
---
1612
import Requirements from '@macros/iam/requirements.mdx'
1713

14+
Scaleway File Storage allows you to create file systems to easily share files across multiple Instances within the same region. File systems are network-attached storage structures that can be accessed by Scaleway Instances to easily share files within your cloud infrastructure.
15+
16+
Each file system can be attached to several Instances, and each Instance can have several file systems attached to it.
17+
18+
This guide teaches you how to quickly create, attach, mount, unmount, detach, and delete a file system using the Scaleway console.
19+
1820
<Requirements />
1921

2022
- A Scaleway account logged into the [console](https://console.scaleway.com)
@@ -27,12 +29,12 @@ import Requirements from '@macros/iam/requirements.mdx'
2729
2. Click **+ Create File system**. The [file system creation page](https://console.scaleway.com//file-storage/file-storage/create) displays.
2830

2931
3. Complete the following steps:
30-
- Select the region in which your file system will be created. It will be accessible by [Instances](/instances/) within the same [region](/file-storage/concepts/#region).
31-
- Enter a name for your file system, or use the automatically generated one. The name of your file system can only contain alphanumeric characters, spaces, and dashes.
32-
- Configure the provisioned size of your file system.
33-
<Message type="note">
34-
File systems are billed based on the provisioned space, and not on actual usage.
35-
</Message>
32+
- Select the region in which your file system will be created. It will be accessible by [Instances](/instances/) within the same [region](/file-storage/concepts/#region).
33+
- Enter a name for your file system, or use the automatically generated one. The name of your file system can only contain alphanumeric characters, spaces, and dashes.
34+
- Configure the provisioned size of your file system.
35+
<Message type="note">
36+
File systems are billed based on the provisioned space, and not on actual usage.
37+
</Message>
3638

3739
4. Review the estimated cost.
3840

@@ -47,10 +49,10 @@ A list of your file systems displays, showing your newly created resource.
4749
2. Click the name of the file system you want to manage. The **Overview** page displays.
4850

4951
3. From this page, you can:
50-
- Resize your file system
51-
- Attach your file system to one or several Instance(s)
52-
- Retrieve the command to mount your file system on your Instance(s)
53-
- Delete your file system
52+
- Resize your file system
53+
- Attach your file system to one or several Instance(s)
54+
- Retrieve the command to mount your file system on your Instance(s)
55+
- Delete your file system
5456

5557
## How to attach a file system to one or more Instance(s)
5658

@@ -72,7 +74,7 @@ To attach a file system to an Instance, you must have [created at least one POP2
7274
File systems can only be attached to POP2 Instances within the same [region](/file-storage/concepts/#region).
7375
</Message>
7476

75-
Your file system is now attached to the selected Instance(s) and can now be [mounted](/file-storage/how-to/mount-file-system/) to a Scaleway Instance.``
77+
Your file system is now attached to the selected Instance(s) and can now be [mounted](/file-storage/how-to/mount-file-system/) to a Scaleway Instance.
7678

7779
## How to mount a file system to a Scaleway Instance
7880

@@ -102,6 +104,21 @@ To mount a file system to an Instance, you must have [attached your file system
102104
You can specify a different mount point by replacing `/mnt` by the desired directory.
103105
</Message>
104106

107+
6. run the command following command to display the file systems of your Instance:
108+
109+
```sh
110+
df -h
111+
```
112+
113+
A list of your file systems displays, containing the one you just mounted:
114+
115+
```sh
116+
Filesystem Size Used Avail Use% Mounted on
117+
tmpfs 794M 992K 793M 1% /run
118+
/dev/sda1 8.0G 2.1G 6.0G 26% /
119+
/dev/sda2 881M 61M 758M 8% /boot
120+
2933ea63-example-file-system-c05fe2 94G 0 94G 0% /mnt
121+
105122
Your file system is now mounted and accessible from the specified mount point in your Instance.
106123

107124
## How to unmount a file system from a Scaleway Instance

0 commit comments

Comments
 (0)