How to create a Kubernetes Kosmos cluster

Reviewed on April 15, 2025

Kubernetes Kosmos provides an alternative to a classic Kubernetes Kapsule. With Kubernetes Kosmos, you can create a Kubernetes cluster comprising both managed Scaleway Instances (with autohealing and autoscaling) and external instances and servers from any other cloud provider. Scaleway ensures the high availability of your services globally, across different zones, regions, and providers. In addition to the Kubernetes Kapsule pricing, you are charged for the Kubernetes Kosmos control plane and an additional fee for managed external nodes.

Before you start

To complete the actions presented below, you must have:

• A Scaleway account logged into 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 you want to manage.
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 Kosmos as the cluster type.
   • Verify 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. Provide a name for the cluster. Optionally, you can add a description and tags for better organization.
6. 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. Choose the pool type. Available types are Scaleway or multi-cloud.
2. Specify the following for each pool:

• For Scaleway pools:
  • Choose the Availability Zone for the pool's nodes.
  • Select the node type for the 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.

• For multi-cloud pools:
  • Specify the external nodes to be added to the pool.
  Important

  Note that autoscaling and autohealing are not available for multi-cloud pools.

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.