# Rasa X Installation Guide

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.

## License Terms

For the use of Rasa X the [Rasa X License Terms](https://storage.googleapis.com/rasa-x-releases/rasa_x_ce_license_agreement.pdf) apply.
For the use of Rasa Enterprise the [Rasa Enterprise License Terms](https://storage.googleapis.com/rasa-x-releases/rasa_x_ee_license_agreement.pdf) apply.

Rasa X can be installed in local mode or on a server using either Kubernetes/OpenShift or Docker Compose. Consider which of the descriptions below best describe your situation and choose an installation method accordingly.

## Local Mode

Rasa X in local mode is helpful for [sharing your assistant](https://legacy-docs-rasa-x.rasa.com/docs/rasa-x/0.39.x/user-guide/share-assistant) before you have a server set up.
Once your assistant is up and running, you will want to deploy Rasa X to a server so that it’s available 24/7 and everyone on your team can use it to review conversations and annotate new training data.

If any of these describe your use case, this method is your best bet:

- You are developing your Rasa assistant and want to chat with it in a UI and share it with others
- You are exploring Rasa X for the first time and just want to see how it works locally

You’ll need to use one of the other installation options if:

- You are ready to deploy your assistant and make it available to end users

[Local Mode Installation Guide](https://legacy-docs-rasa-x.rasa.com/docs/rasa-x/installation-and-setup/install/local-mode)

## Server Quick-Install

This is the simplest and quickest way to install Rasa X on a server or cluster.
If you’re not sure which approach to choose, try this one.

If any of these describe your use case, this method is your best bet:

- You are installing Rasa X for use in production, and do not need much customization.
- You are exploring Rasa X for the first time and want to see how it works on a server.

You’ll need to use one of the other server installation options if:

- Your system does not meet the [requirements](https://legacy-docs-rasa-x.rasa.com/docs/rasa-x/0.39.x/installation-and-setup/install/quick-install-script#requirements)
- You need customizations beyond those [available for this method](https://legacy-docs-rasa-x.rasa.com/docs/rasa-x/0.39.x/installation-and-setup/customize#server-quick-install)
- You expect a lot of traffic to your bot (hundreds of concurrent users) and need to scale.
- You are installing Rasa Enterprise.

[Server Quick-Install Guide](https://legacy-docs-rasa-x.rasa.com/docs/rasa-x/installation-and-setup/install/quick-install-script)

## Helm Chart

Installing Rasa X using the Helm chart is likely a good way to go if any of the following apply to you:

- You are installing Rasa Enterprise.
- You expect a lot of user traffic (hundreds of concurrent users).
- You need to customize things beyond what the quick-install script allows, for example:
  - You have a custom NLU component
  - You need to pull custom images for anything except the action server
  - You need to customize the database

You’ll need to use Docker Compose instead if:

- You do not have and cannot acquire a cluster environment that meets the [requirements](https://legacy-docs-rasa-x.rasa.com/docs/rasa-x/0.39.x/installation-and-setup/install/helm-chart#requirements)

[Helm Chart Installation Guide](https://legacy-docs-rasa-x.rasa.com/docs/rasa-x/installation-and-setup/install/helm-chart)

## Docker Compose

Installing Rasa X on a server using Docker Compose would be a good choice if:

- You can’t or don’t want to use Kubernetes/OpenShift.
- You need more customization than the quick-install script provides.
- You are not expecting large amounts of user traffic (i.e., hundreds of concurrent users).

An install script is available for servers that meet the [hardware and OS requirements](https://legacy-docs-rasa-x.rasa.com/docs/rasa-x/0.39.x/installation-and-setup/install/docker-compose#requirements).
For other operating systems, you can install Rasa X via Docker Compose manually.

[Docker Compose Installation Guide](https://legacy-docs-rasa-x.rasa.com/docs/rasa-x/installation-and-setup/install/docker-compose)