Create scale-clusters.mdx

docs.json

@@ -242,6 +242,7 @@
               "instant-clusters",
               "instant-clusters/configuration",
               "instant-clusters/slurm-clusters",
+              "instant-clusters/scale-clusters",
               {
                 "group": "Deployment guides",
                 "pages": [

instant-clusters/scale-clusters.mdx

@@ -0,0 +1,28 @@
+---
+title: "Scale an Instant Cluster"
+sidebarTitle: "Scale a cluster"
+description: "Add pods to a running Instant Cluster to increase GPU capacity."
+---
+
+You can scale an existing Instant Cluster by adding more pods to it. New pods join the cluster's private network automatically and use the same GPU type as the existing nodes.
+
+## Scale a cluster
+
+1. In the left navigation, go to **Resources** → **Clusters**.
+2. Select the cluster you want to expand.
+3. Click **Scale cluster**.
+4. Under **Additional Pods**, set how many pods to add using the **−** and **+** controls.
+5. Review the **Summary** — it shows your new total GPU count, VRAM, and updated hourly cost.
+6. Click **Scale this cluster** to confirm.
+
+The new pod or pods start provisioning immediately. They appear in the cluster's pod list once they're running.
+
+## What changes when you scale
+
+Each pod you add contributes the same GPU configuration as your existing cluster nodes. For example, a cluster with 1 pod running 2× RTX 4090s (48 GB) becomes a 2-pod cluster with 4× RTX 4090s (96 GB) after adding one pod.
+
+Cost updates to reflect the new total as soon as the additional pods are running.
+
+## Capacity limits
+
+The number of pods you can add depends on available GPU inventory at the time of scaling. If you need more capacity than the stepper allows, click **Talk to our Sales team** in the scaling dialog to discuss a reserved arrangement.