feat(ins): add resize doc

menu/navigation.json

@@ -1430,6 +1430,10 @@
                     "label": "Migrate volumes and snapshots to Scaleway SBS",
                     "slug": "migrate-volumes-snapshots-to-sbs"
                   },
+                  {
+                    "label": "Resize Instances",
+                    "slug": "resize-instances"
+                  },
                   {
                     "label": "Migrate Instances",
                     "slug": "migrate-instances"

pages/instances/faq.mdx

@@ -235,6 +235,11 @@ Yes, each Instance has two DNS hostnames associated with it:
 
 Both are automatically updated when the Instance moves to another hypervisor, also changing its IPv6 and private IPv4. You can either use these hostnames directly or configure a [CNAME record](/dedibox-dns/concepts/#resource-records) linking to it.
 
+### Can I resize my Instance?
+
+Yes, you can resize (also called vertical scaling) your Instance to adjust CPU, RAM, and storage capacity without the need of recreating it.
+* To modify the CPU/RAM configuration of your Instance, refer to the [Instance resizing guide](/instances/how-to/resize-instance).
+* To increase the Block Storage volume of your Instance, refer to the [increasing Block Storage volume size gude](/block-storage/how-to/increase-block-volume/)
 
 ### Can I migrate from a first-generation DEV1 Instance to a PLAY2 Instance?
 

pages/instances/how-to/resize-instances.mdx

@@ -0,0 +1,41 @@
+---
+meta:
+  title: How to resize Instances
+  description: Learn how to adjust the size of your Instances from the Scaleway console to handle varying workloads effectively.
+content:
+  h1: How to resize Instances
+  paragraph: Learn how to adjust the size of your Instances from the Scaleway console to handle varying workloads effectively.
+tags: instance scaling vertically compute
+dates:
+  validation: 2025-05-15
+  posted: 2025-05-15
+categories:
+  - compute
+---
+
+You can adjust the size of your Scaleway Instances (also known as vertical scaling) to meet changing workload demands and optimize resource usage.
+Whether you need to scale up to handle increased traffic, scale down to reduce costs, or simply reconfigure your Instance to better align with your application’s requirements, vertical scaling lets you increase or decrease computational power without the hassle of destroying and recreating Instances.
+Scaleway’s flexible infrastructure allows you to modify CPU and RAM allocation, as well managing your Block Storage vomumes directly from the console, ensuring your resources always match your needs.
+
+Alternatively, you can also resize your Instance using the command-line by following the guide [Changing the commercial type of an Instance with the API or CLI](/instances/api-cli/migrating-instances/).
+
+<Macro id="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
+- An [Instance](/instances/how-to/create-an-instance/) using Block Storage volumes
+
+1. Click **CPU Instances** in the **Compute** section of the side menu. The [Instances page](https://console.scaleway.com/instance/servers) displays.
+2. Click the Instance you want to resize. The **Overview** page for that Instance displays.
+3. Click **Change offer** in the **Instance information** section of the overview page. The change offer page displays.
+    <Lightbox src="scaleway-instance-change-offer.webp" alt="Instance information of the Scaleway console highlighting the change offer link" size="medium" />
+4. Select a new Instance configuration from the list of available offers. Recommended configurations will be highlighted.
+5. Review pricing and compare the monthly cost of the new configuration with your current offer.
+6. Click **Change offer type** to proceed.
+    <Message type="note">
+      The Instance will reboot during the upgrade process, resulting in up to 5 minutes of downtime.
+    </Message>
+
+<Message type="tip">
+  To increase storage capacity of your Instance, refer to the guide on [Increasing Block Storage volume size](/block-storage/how-to/increase-block-volume/).
+</Message>