---

Kubernetes Cluster API Provider STACKIT (CAPSTK)

Kubernetes-native declarative infrastructure for STACKIT.

⚠️ WARNING ⚠️

cluster-api-provider-stackit is not an officially supported STACKIT project and is still in active development.

The implementation is validated through end-to-end tests, but it has not yet received the same level of quality reviews, production hardening, or long-term operational validation as a mature provider or officially supported STACKIT projects.

Use at your own risk. Please review the code carefully before using it in production environments.

What is the Cluster API Provider STACKIT

The Cluster API brings declarative, Kubernetes-style APIs to cluster creation, configuration and management.

The API itself is shared across multiple cloud providers allowing for true STACKIT hybrid deployments of Kubernetes.

Cluster API Provider STACKIT is abbreviated as CAPSTK.

Documentation

Please see our book for in-depth documentation.

Use make serve-book to serve the book locally from this repository.

Install with clusterctl

Create clusterctl.yaml with the published release URL. Replace <version> with the release tag you want to install.

providers:
  - name: stackit
    url: https://github.com/stackitcloud/cluster-api-provider-stackit/releases/download/v<version>/infrastructure-components.yaml
    type: InfrastructureProvider

Install the provider:

clusterctl init --config clusterctl.yaml --infrastructure stackit:v<version>

Launching a Kubernetes cluster on STACKIT

Check out the Quick Start for launching a cluster on STACKIT.

Features

• Native Kubernetes manifests and API
• Doesn't use SSH for bootstrapping nodes.
• Installs only the minimal components to bootstrap a control plane and workers.
• Supports control planes and worker nodes on STACKIT VM instances.
• Manages the bootstrapping of security groups and vm instances (networks are excluded for now).
• Optional Bastion hosts for easier access of control plane or worker nodes
• Tested Kubernetes Lifecycle (Scaling, Kubernetes Upgrades), see E2E-Tests
• ClusterClass Topology
• Support various Linux Distributions (tested with Ubuntu and Flatcar)
• Release distribution via OCI Images and Manifests
• Manage the bootstrapping of networks, security groups and vm instances.
  • Deploys Kubernetes control planes into private subnets with a separate bastion server.
• SKE support

---

Compatibility with Cluster API and Kubernetes Versions

This provider's versions are compatible with the following versions of Cluster API and support all Kubernetes versions that is supported by its compatible Cluster API version:

	Cluster API v1alpha4 (v0.4)	Cluster API v1beta1	Cluster API v1beta2
CAPSTK v1alpha1 (main)	x	x	✓

This provider implements the v1beta2 contract, as declared in metadata.yaml, and is built against sigs.k8s.io/cluster-api v1.13.2.

(See Kubernetes support matrix of Cluster API versions).

---

Getting involved and contributing

Interested in contributing to cluster-api-provider-stackit? We welcome your ideas, contributions, and help. Feel free to reach out to the maintainers to learn how to get involved.

You do not need official write permissions to make an impact. We encourage active community members to take ownership, drive improvements, and help move the project forward.

We are also happy to welcome new maintainers over time. Get involved and show us what you can do!