Skip to content

docs(instances): add offer type change in console #6795

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.

Sign up for GitHub

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

Open
firdevs-a wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs(instances): add offer type change in console #6795

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1599a7b
docs(instances): add offer type change in console
firdevs-a Aug 14, 2026
c06b66e
updated validation date
firdevs-a Aug 14, 2026
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
14 changes: 7 additions & 7 deletions pages/instances/api-cli/migrating-instances.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,18 +3,16 @@ title: Changing the commercial type of an Instance with the API or CLI
description: This page explains how to change the commercial type of a Scaleway Instance with the API or CLI
tags: upgrade instance api
dates:
validation: 2025-09-17
validation: 2026-08-14
posted: 2021-05-26
---
import Requirements from '@macros/iam/requirements.mdx'


It is possible to change the commercial type of an Instance using the [Scaleway CLI](/scaleway-cli/quickstart/) or the [Instances API](https://www.scaleway.com/en/developers/api/instances/).
It is possible to change the commercial type of your Instance using the [Scaleway CLI](/scaleway-cli/quickstart/) or the [Instances API](https://www.scaleway.com/en/developers/api/instances/).
To do so, you need the Instance’s ID and a valid API key.

<Message type="tip">
If you prefer to perform Instance migration from the Scaleway console, refer to our [How to migrate Instances using the console](/instances/how-to/migrate-instances/) documentation.
</Message>
If you prefer to change the commercial type of your Instance from the Scaleway console, see [Resize Instances](/instances/how-to/resize-instances/) documentation.

<Requirements />

Expand All @@ -23,13 +21,15 @@ To do so, you need the Instance’s ID and a valid API key.
- An [Instance](/instances/how-to/create-an-instance/), which must be stopped and not be in a placement group

<Message type="important">
Network interface names may vary across commercial families. Ensure that any hardcoded interface names in your configurations or scripts are updated to avoid migration issues.
Network interface names may vary across commercial families. Check that any hardcoded interface names in your configurations or scripts are updated to avoid migration issues.
</Message>

<Message type="important">
Do **not** manually change the commercial type of **Kubernetes Kapsule nodes** using the API or CLI. Kubernetes Kapsule nodes **must be managed** through Kubernetes. Modifying node types outside of the recommended method can lead to instability or unexpected behavior.
Do not manually change the commercial type of Kubernetes Kapsule nodes using the API or CLI. Kubernetes Kapsule nodes must be managed through Kubernetes. Modifying node types outside of the recommended method can lead to instability or unexpected behavior.

To change the commercial type of your nodes, create a new node pool with the desired Instance type and [migrate your workloads](/kubernetes/how-to/manage-node-pools/#how-to-migrate-existing-workloads-to-a-new-kubernetes-kapsule-node-pool) to the new pool.
</Message>

<Tabs>
<TabsTab label="CLI">

Expand Down
45 changes: 30 additions & 15 deletions pages/instances/how-to/resize-instances.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,19 +1,18 @@
---
title: How to resize Instances
title: Resize Instances
description: 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-12-18
validation: 2026-08-14
posted: 2025-05-15
---
import Requirements from '@macros/iam/requirements.mdx'

import image from './assets/scaleway-instance-change-offer.webp'
You can adjust the size of your Scaleway Instances, also known as vertical scaling, to match changing workload demands and optimize resource usage.

Vertical scaling lets you increase or decrease computational power without destroying and recreating your Instance. Use it to scale up for increased traffic, scale down to reduce costs, or reconfigure an Instance to better fit your application requirements.

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 as manage your Block Storage volumes directly from the console, ensuring your resources always match your needs.
The flexible Scaleway infrastructure lets you modify CPU and RAM allocation, and manage your Block Storage volumes, directly from the console, so 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/).

Expand All @@ -23,18 +22,34 @@ Alternatively, you can also resize your Instance using the command line by follo
- [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 & GPU Instances** in the **Compute** section of the side menu. The [Instances page](https://console.scaleway.com/instance/servers) displays.
2. Select the Availability Zone (AZ) from the drop-down menu (e.g., `PAR1`) to view resources in the selected AZ.
3. Click the Instance you want to resize. The **Overview** page for that Instance displays.
4. Click **Change offer** in the **Instance information** section of the overview page. The change offer page displays.
<Lightbox image={image} alt="Instance information of the Scaleway console highlighting the change offer link" size="medium" />
5. Select a new Instance configuration from the list of available offers. Recommended configurations will be highlighted.
## Change the offer type of active Instances

Changing the offer type of an active Instance includes upgrading within the same Instance generation (for example, from a BASIC3-X6C-12G to a BASIC3-X6C-24G offer) or to a more recent generation (for example, from a BASIC3 to a POP2 offer).

1. In the **Compute** section of the side menu, click **CPU & GPU Instances**. The [Instances page](https://console.scaleway.com/instance/servers) opens.
2. Select the Availability Zone (AZ) from the dropdown (e.g., `PAR1`) to view resources in the selected AZ.
3. Click the Instance you want to resize. Its **Overview** page opens.
4. Click **Change offer** in the **Instance information** section of the overview page. The change offer type page opens.
5. Select a new Instance configuration from the list of available offers. Recommended configurations are highlighted.
- To stay within the same generation, choose another offer from the same commercial range.
- To move to a more recent generation, choose an offer from a different commercial range further down the list.
6. Review pricing and compare the monthly cost of the new configuration with your current offer.
7. 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>
This upgrades your Instance, which reboots in the process, resulting in up to five minutes of downtime.

<Message type="tip">
To increase the storage capacity of your Instance, refer to the guide on [increasing Block Storage volume size](/block-storage/how-to/increase-block-volume/).
</Message>

## Change the offer type of an end-of-life Instance

When an Instance reaches [End of Life](/instances/reference-content/instance-lifecycle/#key-states), Scaleway displays an alert banner on the Instance **Overview** page, informing you that you must upgrade the Instance, and recommends an equivalent offer to migrate to.

1. In the **Compute** section of the side menu, click **CPU & GPU Instances**. The [Instances page](https://console.scaleway.com/instance/servers) opens.
2. Select the Availability Zone (AZ) from the dropdown (e.g., `PAR1`) to view resources in the selected AZ.
3. Click the Instance you want to upgrade. Its **Overview** page opens.
4. Click **Upgrade** in the **Instance information** section of the overview page. The change offer type page opens.
5. Select a new Instance configuration from the list of available offers. The recommended offer is preselected and appears at the top of the list.
6. Review pricing and compare the monthly cost of the new configuration with your current offer.
7. Click **Change offer type** to proceed.
This upgrades your Instance, which reboots in the process, resulting in up to five minutes of downtime.
Loading