feat(ipam): add troubleshooting

menu/navigation.json

@@ -3879,6 +3879,10 @@
                 ],
                 "label": "Additional Content",
                 "slug": "reference-content"
+              },
+              {
+                "label": "Troubleshooting",
+                "slug": "troubleshooting"
               }
             ],
             "label": "IPAM",

pages/ipam/troubleshooting/cant-delete-pn-reserved-ip.mdx

@@ -0,0 +1,37 @@
+---
+meta:
+  title: I can't delete my Private Network due to a reserved IPAM IP
+  description: Troubleshoot issues when you can't delete your Scaleway Private Network due to a reserved IP address in IPAM.
+content:
+  h1: I can't delete my Private Network due to a reserved IPAM IP
+  paragraph: Troubleshoot issues when you can't delete your Scaleway Private Network due to a reserved IP address in IPAM.
+tags: ipam reserved-ip delete
+dates:
+  validation: 2025-05-15
+  posted: 2025-05-15
+categories:
+  - network
+---
+
+You may be attempting to delete a Private Network VPC via the Scaleway console, API, or other developer tool, and see one of the following error messages:
+
+- `resource_still_in_use`
+- `Detach resources from this Private to delete it`
+- `Private Network must be empty to be deleted`
+- `precondition failed: resource_still_in_use`
+
+## Cause
+
+If your Private Network has no attached resources (Instances, Elastic Metal servers etc), this error is probably due to a private IP address being reserved for the Private Network in IPAM.
+
+## Solution
+
+You must release the reserved private IPs from IPAM in order to delete the Private Network.
+
+In the [IPAM section](https://console.scaleway.com/ipam/) of the Scaleway console, use the filters to select the region and VPC of your Private Network. If there are any private IPs reserved for the Private Network, release them.
+
+<Lightbox src="scaleway-ipam-release-ip.webp" alt="A screenshot of the Scaleway console highlights the three dot menu next to a reserved private IP address in IPAM, with the 'Release IP' action" />
+
+<Message type="tip">
+If you cannot see any reserved IPs in IPAM, check again that you have correctly used the **filters** to display reserved IPs for a given region / VPC / Private Network. In the console, IPAM shows **only** reserved IPs for the selected filters. There is no overview of all reserved IPs across all your Private Networks.
+</Message>

pages/ipam/troubleshooting/index.mdx

@@ -0,0 +1,44 @@
+---
+meta:
+  title: IPAM - Troubleshooting
+  description: Find troubleshooting resources for resolving issues with Scaleway IPAM.
+content:
+  paragraph: Find troubleshooting resources for resolving issues with Scaleway IPAM.
+dates:
+  posted: 2025-05-16
+categories:
+  - containers
+---
+
+<ProductHeader
+  productName="IPAM troubleshooting"
+  productLogo="ipam"
+  description="Discover how to solve the most common issues with Scaleway's IP Address Manager service."
+/>
+
+## Featured Pages
+
+<Grid>
+    <DefaultCard
+      title="IPAM FAQ"
+      description="Answers to common questions"
+      url="/ipam/faq/"
+      label="See more"
+    />
+    <DefaultCard
+      title="Reserving an IP address"
+      description="Book a private IP with IPAM"
+      url="/ipam/how-to/reserve-ip/"
+      label="See more"
+    />
+    <DefaultCard
+      title="Understanding IPv6"
+      description="IPv6 in the Scaleway ecosystem"
+      url="/ipam/reference-content/ipv6/"
+      label="See more"
+    />
+</Grid>
+
+## IPAM troubleshooting pages
+
+- [I can't delete my Private Network due to a reserved IPAM IP](/ipam/troubleshooting/cant-delete-pn-reserved-ip/)