Skip to main content
Version: 0.9



Starting with Turtles v0.9.0, the process used for importing CAPI clusters into Rancher is now based on a different controller logic. If you are a new user of Turtles, you can proceed normally and simply install the extension. If you have been using previous versions of Turtles and are upgrading to v0.9.0, we recommend you take a look at the migration mechanisms and their implications:

Rancher Turtles is a Kubernetes Operator that provides integration between Rancher Manager and Cluster API (CAPI) with the aim of bringing full CAPI support to Rancher. With Rancher Turtles, you can:

  • Automatically import CAPI clusters into Rancher, by installing the Rancher Cluster Agent in CAPI provisioned clusters.
  • Configure the CAPI Operator.


This demo shows how to use the Rancher UI to install Rancher Turtles, create/import a CAPI cluster, and install monitoring on the cluster:


Kubernetes cluster>=1.26.0
Rancher`>=2.8.1Using helm based installation on any kubernetes cluster directly or on a newly created Amazon, Azure or Google service based options. Additional feature gate modifications are required.
Cert-manager>=v1.12.0Using helm based installation or via kubectl apply.
Cluster API Operator>=v0.9.1Using Rancher UI (recommended) or Helm install (for development use cases)
Cluster APIv1.4.6
Rancher Turtlesv0.8.0Using Rancher UI (recommended) or Helm install (for advanced use cases)

Reference Guides

This section focuses on implementation details including architecture, how Rancher Turtles integrates with Rancher, and Helm Chart configuration values.


In this section we cover additional operational tasks including basic CAPIProvider installation, an example AWS infrastructure provider install using CAPIProvider, and upgrade instructions for early adopters of Rancher Turtles.


Rancher Turtles meets SLSA Level 3 requirements as an appropriate hardened build platform, with consistent build processes, and provenance distribution. This section contains more information on security-related topics: