Skip to main content

Start with creating a cluster

You’ll connect or create at least one cluster before you deploy apps.

For screenshots and bare-metal sizing, use Set up your first cluster. For advanced hardening, use the operator reference.

Before you start​

  • You are the organization owner — adding a cluster, node SSH, and cluster settings stay owner-only
  • An existing cluster or machines / cloud resources to create one
  • A connection file (YAML) when connecting an existing cluster
  • Network reachability from Xooshe to the cluster API — network guide

Connect an existing cluster​

  1. Open the dashboard → Select Cluster → + Add Cluster.
  2. Choose Add an Existing Kube Config (upload your connection file).
  3. Enter a cluster name and upload the YAML file.
  4. Confirm.

Create a new cluster​

  1. + Add Cluster → Create A New Cluster from Scratch.
  2. Follow the SSH or cloud steps in the UI.
  3. Wait until provisioning finishes, then add worker nodes as needed.

You’re done when​

  • The cluster appears in the selector.
  • Environments, Shared variables, and Nodes are available.
  • Nodes move toward a healthy / Ready state.