Installing Charmed Kubernetes

In addition to the easy to follow tutorial for Charmed Kubernetes, additional guides are available to take you through the installation steps for a number of different substrates. The 'Cloud' install page covers many different scenarios with Juju-supported clouds.

Warning:

Canonical is decommissioning the rocks.canonical.com container image registry as part of our infrastructure modernization. The registry will be unavailable after August 31, 2026. This affects Charmed Kubernetes releases 1.35 and earlier. New Charmed Kubernetes 1.36+ deployments use ghcr.io/canonical/cdk by default. Existing deployments, or deployments with an overridden image-registry value, must be migrated. Configure the image-registry value for each deployed component charm that uses Canonical images, including CNI and CSI charms. See the list of affected charms.

juju config <charm> image-registry=ghcr.io/canonical/cdk

For example:

juju config kubernetes-control-plane image-registry=ghcr.io/canonical/cdk

There are also two 'special case' scenarios we provide guidance for:

If you wish to uninstall:

We appreciate your feedback on the documentation. You can edit this page or file a bug here.

See the guide to contributing or discuss these docs in our public Slack channel.