Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
d8613b4
feat(ipam): public ips management
SamyOubouaziz Aug 27, 2026
2cc02cb
feat(ipam): update
SamyOubouaziz Aug 27, 2026
d8774f1
feat(ipam): update
SamyOubouaziz Aug 27, 2026
cfffae2
feat(ipam): update
SamyOubouaziz Aug 27, 2026
7cddc1b
feat(ipam): update
SamyOubouaziz Aug 31, 2026
32ebe70
feat(ipam): update
SamyOubouaziz Aug 31, 2026
0441c0b
feat(ipam): update
SamyOubouaziz Aug 31, 2026
e3308a5
feat(ipam): update
SamyOubouaziz Sep 1, 2026
b7e0443
feat(ipam): update
SamyOubouaziz Sep 1, 2026
c60f15f
feat(ipam): update
SamyOubouaziz Sep 1, 2026
acb542b
feat(ipam): add understanding page
SamyOubouaziz Sep 28, 2026
b90f272
feat(ipam): update list ips page
SamyOubouaziz Oct 13, 2026
594f5bb
feat(ipam): update reverse dns
SamyOubouaziz Oct 13, 2026
a05ec31
feat(ipam): update reverse dns
SamyOubouaziz Oct 13, 2026
ce89568
feat(ipam): add understanding ipam
SamyOubouaziz Oct 20, 2026
0893337
feat(ipam): update managing ips
SamyOubouaziz Oct 20, 2026
541e00b
feat(ipam): remove old mentions of private
SamyOubouaziz Oct 20, 2026
3477b81
feat(ipam): remove old mentions of private
SamyOubouaziz Oct 20, 2026
4122d17
feat(ipam): remove mentions of flex IP in IPAM doc
SamyOubouaziz Oct 26, 2026
492e33a
Apply batched suggestions from code review
SamyOubouaziz Oct 27, 2026
1080087
Apply batched suggestions from code review
SamyOubouaziz Oct 27, 2026
2ba6b95
Apply batched suggestions from code review
SamyOubouaziz Oct 27, 2026
8e1100c
Apply suggestion from @vanda-scw
SamyOubouaziz Oct 27, 2026
c06e8c6
Apply batched suggestions from code review
SamyOubouaziz Oct 27, 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
2 changes: 1 addition & 1 deletion pages/instances/how-to/configure-reverse-dns.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -35,5 +35,5 @@ Reverse DNS is the opposite of classic "forward" DNS and maps an IP address to a
</Message>

<Message type="tip">
You cannot set reverse DNS for individual addresses within a flexible IPv6 /64 block via the Scaleway console. See our dedicated documentation on [how to use the IPAM API](/ipam/api-cli/set-ip-reverse/) for this purpose.
To set reverse DNS for individual addresses within a flexible IPv6 /64 block, use [IPAM](/ipam/how-to/set-ip-reverse/).
</Message>
51 changes: 0 additions & 51 deletions pages/ipam/api-cli/set-ip-reverse.mdx

This file was deleted.

Binary file removed pages/ipam/assets/scaleway-ipam-moreinfo.webp
Binary file not shown.
Binary file removed pages/ipam/assets/scaleway-reserve-ip.webp
Binary file not shown.
27 changes: 16 additions & 11 deletions pages/ipam/concepts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,24 +14,17 @@ When viewing a private IP address in IPAM, it is shown in [CIDR notation](https:

IP Address Manager (IPAM) is the Scaleway tool for planning, tracking, and managing the IP address space of Scaleway products. It acts as a single source of truth for the IP addresses of Scaleway resources. Managed products, such as Databases and Load Balancer, are fully integrated into IPAM, and the [DHCP server](/vpc/concepts/#dhcp) of Private Networks uses IPAM to assign private, static IP addresses to attached resources.

The public rollout of IPAM functionality is being carried out gradually. IPAM is now in General Availability, offering several different functionalities in the [Scaleway console](https://console.scaleway.com/ipam/), including viewing, tagging, and filtering all your [private IP addresses](#private-ip-address). You can also [reserve](/ipam/how-to/reserve-ip/) a private IP on one of your Private Networks and use it to attach an Instance, Load Balancer, Public Gateway, or Elastic Metal server to the network.

More functionality is planned for the future, including:

- Support for attaching Managed Databases and other resources to a Private Network using a reserved IP address
- Management of public (flexible) IP addresses

## IPv4

Internet Protocol Version 4 (IPv4) is the standard protocol used for IP addresses, and routes most internet traffic as of today. Each IPv4 address has 32 bits. Written in human-readable form, an IPv4 address is generally shown as four octets separated by periods, e.g., `151.115.59.87`.

Scaleway resources may have a [public](#public-flexible-ip-address) IPv4 address (flexible IP) for accessibility from the public internet, and will have a [private](#private-ip-address) IPv4 address for each Private Network they are attached to.
Scaleway resources may have a [public](#public-flexible-ip-address) IPv4 address for accessibility from the public internet, and will have a [private](#private-ip-address) IPv4 address for each Private Network they are attached to.

## IPv6

Internet Protocol Version 6 (IPv6) is the most recent version of the IP protocol used for IP addresses. Each IPv6 address has 128 bits. Written in human-readable form, an IPv6 address can be shown as eight groups of four hexadecimal digits, each group representing 16 bits and separated by a colon, e.g., `2001:0DB8:0000:0003:0000:01FF:0000:002E`. This can also be notated as `2001:DB8::3:0:1FF:0:2E`.

IPv6-compatible Scaleway resources may have a [public](#public-flexible-ip-address) IPv6 address (flexible IP) for accessibility from the public internet, and will have a [private](#private-ip-address) IPv6 address for each Private Network they are attached to. For more details, see [IPv6 and the Scaleway ecosystem](/ipam/reference-content/ipv6/).
IPv6-compatible Scaleway resources may have a [public](#public-flexible-ip-address) IPv6 address for accessibility from the public internet, and will have a [private](#private-ip-address) IPv6 address for each Private Network they are attached to. For more details, see [IPv6 and the Scaleway ecosystem](/ipam/reference-content/ipv6/).

## Private IP address

Expand All @@ -52,8 +45,20 @@ Public IP addresses identify devices on the public internet. You can enter the p

Depending on the type of resource and its configuration, it may or may not have a public IP address. For example, you can choose to give an [Instance](/instances/) one or more public IP addresses ([IPv4](#ipv4) and/or IPv6), or alternatively, no public IP address at all. To find out more about managing public connectivity, see the [public connectivity best practices](/ipam/reference-content/public-connectivity-best-practices/).

Public IP addresses at Scaleway are often called flexible IP addresses, because you can move them between different resources. However, flexible IP addresses are scoped to a single product and to a single Availability Zone. If you create a flexible IP address for an Instance in `PAR-2`, you can move it to a different Instance in `PAR-2`, but not to an Instance in `PAR-1`, nor to an Elastic Metal server in any AZ.
Public IP addresses at Scaleway used to be referred to as "flexible IP addresses", because you can move them between different resources. Each public IP address is either [zonal](#zonal-ip-address) or [regional](#regional-ip-address), and this scope determines the resources you can move it to.

## Regional IP address

Regional IP addresses are scoped to a single Scaleway region (such as `FR-PAR`, or `NL-AMS`). If you reserve a public regional IP address for an Instance in `PAR-2`, you can move it to a resource in a different Availability Zone within this Region, such as `PAR-1`. Regional IPs can be used as failover IPs, by switching from a resource in one AZ to a backup resource in a different AZ in case of failure, ensuring high availability for this resource.

## Reserved IP address

A reserved IP address is a private IP address from the [CIDR block](/vpc/concepts/#cidr-block) of a given Private Network, that you have [reserved via IPAM](/ipam/how-to/reserve-ip/). Reserving an IP means that it can no longer be auto-allocated by DHCP to resources that join the network. You can then use the reserved IP to attach a specified resource of your choice to the Private Network. After you detach the resource, the IP remains reserved, and you can either use it to attach a different resource, or release it back into the pool of generally available IPs.
A reserved IP address is an address that you have [reserved via IPAM](/ipam/how-to/reserve-ip/), and that is held in your Organization until you [release](/ipam/how-to/release-ip/) it. You can reserve a [private](#private-ip-address) IP address, a [public zonal](#zonal-ip-address) IP address, or a [public regional](#regional-ip-address) IP address.

Reserving a private IP from the [CIDR block](/vpc/concepts/#cidr-block) of a Private Network means that it can no longer be auto-allocated by DHCP to resources that join the network. You can then use it to attach a specified resource of your choice to the Private Network.

Whatever its source, a reserved IP address remains reserved after you detach or delete the resource it was attached to. You can either use it to attach a different resource, or release it back into the pool of generally available IPs.

## Zonal IP address

Zonal IP addresses are scoped to a single Availability Zone. If you reserve a public zonal IP address for an Instance in `PAR-2`, you can move it to a different Instance or VPN gateway in `PAR-2`, but not to a resource in `PAR-1`.
10 changes: 4 additions & 6 deletions pages/ipam/faq.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,15 +14,13 @@ productIcon: IpamProductIcon

### What can I do with IPAM?

The public rollout of IPAM functionality is being carried out gradually. IPAM is now in General Availability, offering several different functionalities in the [Scaleway console](https://console.scaleway.com/ipam/), including viewing, tagging, and filtering all your [private IP addresses](/ipam/concepts/#private-ip-address). You can also [reserve](/ipam/how-to/reserve-ip/) a private IP on one of your Private Networks and use it to attach a specified resource to the network.

Management of public (flexible) IP addresses with IPAM is planned for the future.
IPAM is in General Availability, and covers all your IP addresses in the [Scaleway console](https://console.scaleway.com/ipam/): [private IP addresses](/ipam/concepts/#private-ip-address) on your Private Networks, [public zonal](/ipam/concepts/#zonal-ip-address) IP addresses, and [public regional](/ipam/concepts/#regional-ip-address) IP addresses. You can view, tag, and filter them, [reserve](/ipam/how-to/reserve-ip/) an address of any type (private, public zonal, public regional), and [release](/ipam/how-to/release-ip/) it when you no longer need it.

## Compatibility and integration

### Can I use a reserved private IP to attach any kind of managed resource to a Private Network?

Currently, the Scaleway console only supports attachment with a reserved IP for Instances, Load Balancers, Public Gateways, and Elastic Metal servers. Support for Managed Databases will be coming soon.
Currently, the Scaleway console only supports attachment with a reserved IP for Instances, Load Balancers, Public Gateways, and Elastic Metal servers.

### Can I use a reserved private IP with a virtual machine hosted on my Elastic Metal server?

Expand All @@ -32,6 +30,6 @@ Yes, this functionality is now available via the Scaleway console and API. Simpl

BYOIP is not currently available at Scaleway, but we are aware that there is a demand for this service. We recommend that you add or upvote a [feature request](https://feature-request.scaleway.com/) to register your interest.

## Can I request that I get a specific IP address when creating a flexible IP?
## Can I request that I get a specific IP address when reserving a public IP?

No, this is not possible. Flexible (public) IP addresses are allocated from a pool of addresses, and you cannot specify an address when creating one.
No, this is not possible. Public IP addresses are allocated from a pool of addresses, and you cannot specify an address when creating one.
Binary file not shown.
Binary file removed pages/ipam/how-to/assets/scaleway-reserve-ip.webp
Binary file not shown.
38 changes: 38 additions & 0 deletions pages/ipam/how-to/attach-resource.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
title: How to attach a resource using a reserved private IP
description: Learn how to attach managed and custom resources to a Scaleway Private Network using an IP address reserved with IPAM.
tags: ipam ip-address-manager private-ip-address reserved-ip attach private-network custom-resource
dates:
validation: 2026-08-27
Comment thread
SamyOubouaziz marked this conversation as resolved.
Resolved
posted: 2026-08-27
---
import Requirements from '@macros/iam/requirements.mdx'


Once you have [reserved a private IP address](/ipam/how-to/reserve-ip/) with IPAM, you can use it to attach a resource of your choice to the Private Network the address belongs to. The resource keeps this address for as long as it is attached, and the address stays reserved even after you detach or delete the resource.

This page shows you how to attach both Scaleway-managed resources and custom resources to a Private Network using a reserved IP address.

<Requirements />

- A Scaleway account logged in to 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
- A [reserved private IP address](/ipam/how-to/reserve-ip/) on one of your Private Networks

## Attach a managed resource to a Private Network using a reserved IP address

You can currently attach **CPU & GPU Instances**, **Elastic Metal servers**, **Load Balancers**, and **Public Gateways** to Private Networks using a reserved IP address.

The option to use a reserved IP is displayed when you attach the resource to a Private Network in the console. Follow the instructions that match your use case:

- Attach a resource to a Private Network from the [Private Networks](/vpc/how-to/attach-resources-to-pn/) product dashboard
- Attach an Instance to a Private Network from the [Instances](/instances/how-to/use-private-networks/#how-to-attach-instances-to-an-existing-private-network) product dashboard
- Attach an Elastic Metal server to a Private Network from the [Elastic Metal](/elastic-metal/how-to/use-private-networks/) product dashboard
- Attach a Load Balancer to a Private Network from the [Load Balancer](/load-balancer/how-to/use-with-private-network/) product dashboard
- Attach a Public Gateway to a Private Network from the [Public Gateways](/public-gateways/how-to/configure-a-public-gateway/#how-to-attach-a-public-gateway-to-a-private-network) product dashboard

## Attach a custom resource to a Private Network using a reserved IP address

You can use reserved private IP addresses to attach custom resources, such as VMs hosted on Elastic Metal servers, to Scaleway Private Networks. In doing so, you are prompted to specify the MAC address of the custom resource.

Attach the custom resource from the Private Network dashboard in the Scaleway console by following the [How to attach resources to a Private Network](/vpc/how-to/attach-resources-to-pn/) procedure.
35 changes: 14 additions & 21 deletions pages/ipam/how-to/list-ips.mdx
Original file line number Diff line number Diff line change
@@ -1,41 +1,34 @@
---
title: How to list your private IP addresses
description: This page explains how to list your private IP addresses with Scaleway's IPAM
tags: ipam ip-address-manager private-ip-address ip-address ip filter reserve-ip-address
title: How to list your IP addresses
description: This page explains how to list and filter your public and private IP addresses with Scaleway's IPAM
tags: ipam ip-address-manager private-ip-address public-ip-address ip-address ip filter zonal regional
dates:
validation: 2025-09-22
validation: 2026-08-27
posted: 2024-05-30
---
import Requirements from '@macros/iam/requirements.mdx'


**IP** **A**ddress **M**anager (IPAM) is Scaleway's tool for planning, tracking and managing the IP address space of Scaleway products. It acts as a single source of truth for the IP addresses of Scaleway resources.
IP Address Manager (IPAM) is the Scaleway tool for planning, tracking, and managing the IP address space of Scaleway products. It acts as a single source of truth for the IP addresses of Scaleway resources.

[Read more about IPAM and future planned functionality](/ipam/concepts/#ipam).

You can currently use IPAM in the Scaleway console to manage the IP address space of your Scaleway Private Networks. This document shows you how to list the [private IP addresses](/ipam/concepts/#private-ip-address) of all your Scaleway resources attached to Private Networks.
This page shows you how to list and filter your [public](/ipam/concepts/#public-flexible-ip-address) and [private IP addresses](/ipam/concepts/#private-ip-address) using the Scaleway console.

<Requirements />

- A Scaleway account logged into the [console](https://console.scaleway.com)
- [Owner](/iam/concepts/glossary/#owner) status or [IAM permissions](/iam/concepts/glossary/#permission) allowing you to perform actions in the intended Organization
- At least one resource [attached to a Private Network](/vpc/how-to/attach-resources-to-pn/).

## How to list and filter your private IP addresses

1. Click **IPAM** in the **Network** section of the [Scaleway console](https://console.scaleway.com) side menu.

A list of your **private IP addresses** for the **region** and **VPC** pre-selected in the filters displays. Addresses are displayed here if they are reserved in IPAM. This means either:
## List and filter your IP addresses

- You [reserved an address via IPAM](/ipam/how-to/reserve-ip/), or
- You [attached a resource to a Private Network](/vpc/how-to/attach-resources-to-pn/): this triggers IPAM to reserve and attach an IP address for the resource on the network.
1. In the [Scaleway console](https://console.scaleway.com) side menu, go to **Network** > **IPAM**.

The full range of IP addresses which are available but unreserved in each of your Private Network's [CIDR blocks](/vpc/concepts/#cidr-block) do not display in the list.
2. Select the desired region using the dropdown at the top of the page.

<Message type="tip">
When viewing a private IP address in IPAM, it is shown in [CIDR notation](https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing#CIDR_notation). For example, the address `172.16.12.2/22` represents the IPv4 address `172.16.12.2`and its associated CIDR block `172.16.12.0/22`, defined on the [Private Network](/vpc/how-to/create-private-network/#how-to-configure-cidr) and containing 1024 addresses.
</Message>
3. Select the **source** of the addresses to display:

2. Modify the filters of the list using the drop-down menus at the top. You can filter for IP addresses within a given **region**, **VPC** and/or **Private Network**. You can also opt to filter for only [IPv4](/ipam/concepts/#ipv4) or [IPv6](/ipam/concepts/#ipv6) addresses:
- **Private IPs**: private addresses on your Private Networks. Select a **VPC**, and optionally a **Private Network**, to display them.
- **Public zonal IPs**: public addresses scoped to a single Availability Zone. Select a **zone** to display them.
- **Public regional IPs**: public addresses scoped to the whole selected region.

3. Click **Apply filters** to activate the filters you chose, or **Reset** to reset all filters.
4. Use the other filters for each source to refine your search, or click **All filters** to display the full set of filters available for the selected source.
Loading
Loading