diff --git a/pages/container-registry/troubleshooting/index.mdx b/pages/container-registry/troubleshooting/index.mdx
new file mode 100644
index 0000000000..d1e48d6177
--- /dev/null
+++ b/pages/container-registry/troubleshooting/index.mdx
@@ -0,0 +1,45 @@
+---
+meta:
+  title: Container Registry - Troubleshooting
+  description: Find troubleshooting resources for resolving issues with Container Registry.
+content:
+  paragraph: Find troubleshooting resources for resolving issues with Container Registry.
+dates:
+  posted: 2025-03-10
+categories:
+  - containers
+---
+
+<ProductHeader
+  productName="Container Registry troubleshooting"
+  productLogo="containerRegistry"
+  description="Learn how to fix the most common issues with Scaleway's Container Registry."
+/>
+
+## Featured Pages
+
+<Grid>
+    <DefaultCard
+      title="Container Registry FAQ"
+      description="General info on Container Registry."
+      url="/faq/container-registry/"
+      label="See more"
+    />
+    <DefaultCard
+      title="Common errors when pushing images to Container Registry"
+      description="Troubleshoot issues that may prevent you from pushing images to Scaleway's Container Registry."
+      url="/container-registry/troubleshooting/common-errors-when-pushing-images-to-container-registry/"
+      label="See more"
+    />
+    <DefaultCard
+      title="Container Registry API documentation"
+      description="Learn how to interact with Container Registry using the API."
+      url="https://www.scaleway.com/en/developers/api/registry/"
+      label="See more"
+    />
+</Grid>
+
+
+## Container Registry troubleshooting pages
+
+- [Common errors when pushing images to Container Registry](/container-registry/troubleshooting/common-errors-when-pushing-images-to-container-registry/)