How to create a Kubernetes Kapsule cluster

Reviewed on August 05, 2025

Scaleway Kubernetes Kapsule provides a managed environment for creating, configuring, and operating a cluster of preconfigured nodes for containerized applications. This service allows you to deploy Kubernetes clusters without the complexity of managing the underlying infrastructure.

Key benefits include:

• Dynamic scaling of Pods based on workload demands.
• Simplified cluster management via kubectl, the Kubernetes command-line tool.

To facilitate cluster administration, Scaleway provides a .kubeconfig file, enabling you to manage your cluster locally using kubectl. This tool is essential for executing commands against Kubernetes clusters.

Before you start

To complete the actions presented below, you must have:

• A Scaleway account with access to the console
• Owner status or IAM permissions allowing you to perform actions in the intended Organization

Cluster configuration

1. Navigate to Kubernetes under the Containers section of the Scaleway console side menu. The Kubernetes dashboard displays.
2. From the drop-down menu, select the geographical region where you want to create your cluster.
3. Click Create cluster to launch the cluster creation wizard.
4. On the cluster configuration page, provide the following details:
   • Check the Organization and Project for the new cluster.
     Important

     You cannot move a cluster from one Organization or Project to another once created.

   • Select Kubernetes Kapsule as the cluster type, which uses exclusively Scaleway Instances.
   • Confirm the geographical region for the cluster.
   • Select the control plane offer for your cluster. Options include shared or dedicated control planes.
     Tip

     Need help deciding on a control plane offer? Learn more about our Kubernetes control plane offers.

   • Specify the Kubernetes version for your cluster.
5. Enter the cluster's details. Provide a name for the cluster. Optionally, you can add a description and tags for better organization.
6. Configure the Private Network for the cluster to ensure secure and isolated network communication. Each cluster is auto-configured with a /22 IP subnet. Click Select Private Network to:
   • Attach an existing Private Network (VPC) within the same Availability Zone from the drop-down menu.
   • Attach a new Private Network to the cluster.
   Important

   The Private Network cannot be detached, and the cluster cannot be moved to another Private Network post-creation.

7. Click Configure pools to proceed.

Pool configuration

This section outlines the settings for your cluster pools. You can configure as many pools for your cluster as you require.

1. Configure the following for each pool:
   • Choose an Availability Zone for the pool's nodes.
   • Select the node type for the pool.
     Tip

     Need advice on choosing a node type? Learn more about Kubernetes nodes.

   • Configure the system volume. This volume contains the operating system of the nodes in your pool.
   • Configure pool options, including node count and whether to enable autoscaling. Options also include enabling autoheal and linking to a placement group, or you can retain default settings.
     Tip

     • Unsure about the autoheal feature? Learn more about autoheal.
     • Need more information about placement groups? Learn more about placement groups.
   • Enable full isolation, if required.
     Tip

     Need more information on full isolation? Learn more about full isolation.

2. Click Add pool to integrate the pool into the cluster.
3. To add more pools, click Expand and repeat the steps above.
   Tip

   You can add or remove pools as needed before finalizing your cluster configuration. To remove a pool, click Remove within the respective pool.

4. Once all pools are configured, click Review to finalize your cluster setup.

Review configuration

1. Review the configuration details of your Kubernetes cluster and its pools.
   Tip

   To modify any element, click the edit icon Edit icon next to the respective configuration component.

2. Click Create cluster to deploy your cluster. Once deployment is complete, the cluster appears in the clusters list.