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.
<span class="p-notification__title">Warning:</span>
<p class="p-notification__message">Canonical is decommissioning the <code>rocks.canonical.com</code> container image registry as part of our infrastructure modernization. The registry will be unavailable after <strong>September 30, 2026</strong>. This affects Charmed Kubernetes releases 1.35 and earlier. New Charmed Kubernetes 1.36+ deployments use <code>ghcr.io/canonical/cdk</code> by default. Existing deployments, or deployments with an overridden <code>image-registry</code> value, must be migrated. Configure the <code>image-registry</code> value for each deployed component charm that uses Canonical images, including CNI and CSI charms. See the <a href="/kubernetes/charmed-k8s/docs/rocks-registry-affected-charms">list of affected charms</a>. If you encounter any issues, you can reach us via the <a href="/kubernetes/charmed-k8s/docs/get-in-touch">support channels</a>.</p>
juju config <charm-name> 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:
See the guide to contributing or discuss these docs in our public Slack channel.