# Rasa X Installation Instructions

Rasa X version 0.33.0 or higher is only compatible with Rasa Open Source 2.x. If you are on Rasa Open Source 1.x, please check the [compatibility matrix](https://legacy-docs-rasa-x.rasa.com/docs/rasa-x/changelog/compatibility-matrix) for a compatible version.

To install the Rasa X Helm chart, you need to have the Helm and Kubernetes/OpenShift CLI installed.

## Step 1: Check Kubernetes or OpenShift CLI Installation

Please check that you installed the Kubernetes or OpenShift command line interface (CLI). You can check this using the following command:

### - Kubernetes
### - OpenShift

```bash
kubectl version --short --client
```

The output should be similar to this:

```
Client Version: v1.16.3
```

If this command resulted in an error, please install the [Kubernetes CLI](https://kubernetes.io/docs/tasks/tools/install-kubectl/) or the [OpenShift CLI](https://docs.openshift.com/container-platform/4.3/cli_reference/openshift_cli/getting-started-cli.html#cli-installing-cli_cli-developer-commands) depending on the cluster you’re using.

## Step 2: Connect to Your Cluster

Make sure that the Kubernetes / OpenShift CLI is correctly connected to your cluster. You can do so by using the following commands:

### - Kubernetes
### - OpenShift

```bash
kubectl version --short
```

The output should be similar to this:

```
Client Version: v1.16.3
Server Version: v1.14.8-gke.12
```

If you get an error when executing the command, you are not connected to your cluster. To get the command to connect to the cluster please consult your cluster’s admin or the documentation of your cloud provider.

If you are using [K3s](https://k3s.io/) for an embedded Kubernetes installation, please make sure that you exported the path to the Kubernetes config:

```bash
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
```

## Step 3: Check Helm CLI Installation

Please make sure you have the [Helm CLI](https://helm.sh/docs/intro/install/) installed. To check this, run:

```bash
helm version --short
```

The output should be similar to this:

```
v3.0.0+ge29ce2a
```

If this command leads to an error, please install the [Helm CLI](https://helm.sh/docs/intro/install/).

In case you are using a version `<3` of Helm, please update to Helm version `3`.