> For the complete documentation index, see [llms.txt](https://docs.cedana.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cedana.ai/cedana-kubernetes/installation.md).

# Installation

We provide a helm chart to easily install our services on your cluster.

{% hint style="success" %}
To use Cedana in Kubernetes, you need to be registered with us! Reach out to [founders@cedana.ai](mailto:foundes@cedana.ai) to get set up with an organization.
{% endhint %}

{% hint style="info" %}
You can also deploy fully self-hosted, with zero limitations on where you can store your checkpoints! Check out [configuration](/cedana-kubernetes/configuration.md). If you have any questions, please reach out to us at <founders@cedana.ai>.
{% endhint %}

## Install

{% hint style="success" %}
To install Cedana on your cluster, you need to be authenticated. See [authentication](/get-started/authentication.md).
{% endhint %}

1. Make sure you have the `helm` tool installed. See the [Helm installation guide](https://helm.sh/docs/intro/install/) for instructions.
2. Register a new cluster on the [Clusters Page](https://ui.cedana.com/monitoring/clusters).

<figure><img src="/files/4Fdn1RiIBmC1RGXSR2av" alt=""><figcaption></figcaption></figure>

3. Once you've registered your cluster, you'll receive a `clusterId`. Use this `clusterId`, along with your `authToken` and `url` to install the helm chart below.

<figure><img src="/files/YvdhNBXFM68SZbnDshWf" alt=""><figcaption></figcaption></figure>

4. Run the following command to install the helm chart:

```bash
export CEDANA_AUTH_TOKEN=<your-auth-token>
export CEDANA_CLUSTER_ID=<cluster_id>
export CEDANA_URL=<your-org-url>

helm upgrade -i cedana oci://registry-1.docker.io/cedana/cedana-helm  \
 --create-namespace -n cedana-system \
 --set=config.clusterId=$CEDANA_CLUSTER_ID \
 --set=config.url=$CEDANA_URL \
 --set=config.authToken=$CEDANA_AUTH_TOKEN
```

Take a look at [Configuration](/cedana-kubernetes/configuration.md) for customizing your Cedana installation.

You're all set up! Let's checkpoint some workloads. Continue to [Checkpoint/restore](/cedana-kubernetes/cr.md) to get started.

## Uninstall

To uninstall Cedana completely, simply do:

```bash
helm uninstall cedana -n cedana-system
```