# 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](https://docs.cedana.ai/cedana-kubernetes/configuration). 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](https://docs.cedana.ai/get-started/authentication).
{% 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="https://3970289663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2VUqakyWqaX9NCnQNYjD%2Fuploads%2FHqP4Psgh6pbSaEJEoZ3I%2Fimage.png?alt=media&#x26;token=a54661d6-b06f-4f9f-bdc6-adc2660161fb" 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="https://3970289663-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2VUqakyWqaX9NCnQNYjD%2Fuploads%2F60dahD8JKLMmZeu4MKe5%2Fimage.png?alt=media&#x26;token=fb231499-7548-4a81-8438-12c2d12292c6" 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](https://docs.cedana.ai/cedana-kubernetes/configuration) for customizing your Cedana installation.

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

## Uninstall

To uninstall Cedana completely, simply do:

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cedana.ai/cedana-kubernetes/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.