Quick-Installation

License Terms

For the use of Rasa X the Rasa X License Terms apply. For the use of Rasa Enterprise the Rasa Enterprise License Terms apply.

The simplest and quickest way to install Rasa X on a server or cluster is to use our quick-install script.

To install Rasa X, simply run the command below in a compatible environment (see Requirements):

curl -s get-rasa-x.rasa.com | sudobash

installing edge vs. stable

By default, the quick-install script will install the latest stable release of Rasa X. To install the latest edge release of Rasa X, run the following instead:

export RASA_X_VERSION="latest"
# -E flag applies environment variables from the current user for `sudo`
curl -s get-rasa-x.rasa.com | sudo -E bash

When done, the script will print the URL to access Rasa X:

You can now access Rasa X on this URL: <--URL-->

The script will perform the following steps:

  1. Install an embedded Kubernetes cluster. If the Kubernetes command-line interface kubectl is already configured, it will use the configured cluster. Please see Existing Cluster Installation for more details if you are interested in using the script with an existing Kubernetes cluster.
  2. Install the Helm command-line interface.
  3. Install Rasa X using the Rasa X Helm Chart.

Requirements

Hardware & OS Requirements

Rasa X is intended to be deployed on a server and not to a personal/local machine. Deploying on a server is recommended because Rasa X is designed to stay up continuously, and not to be frequently stopped or restarted.

The installation script is officially supported on the following operating systems:

You can also use this script to run Rasa X on Windows or MacOS using Multipass. For any other Linux operating systems, please follow the Docker Compose Manual Installation instructions.

Embedded Cluster Requirements

In case you don’t have an existing Kubernetes Cluster, the installation script will set up an embedded Kubernetes cluster on your machine. To run Rasa X on your machine, it should have the following hardware specs:

vCPUs

RAM

Disk Space

Supported Browsers

The web interface aims to support browsers that meet the following criteria:

Installation

Embedded Cluster Installation

Before installing using the script you’ll need a deployment environment that can run Rasa X. Please see the Requirements for the requirements.

Once you are ready, run the install command:

curl -s get-rasa-x.rasa.com | sudobash

When done, the script will print the URL to access Rasa X:

You can now access Rasa X on this URL: <--URL-->

Rasa X will be installed in the Kubernetes namespace rasa, with a Helm release name rasa.

Existing Cluster Installation

You can also use this installation method with an existing Kubernetes cluster. The existing cluster has to be configured with the Kubernetes command-line-interface kubectl. To see if kubectl is installed on your machine and if it is correctly connected to a cluster run the following command:

# Since the installation script runs as `root`,
# you have to check the `kubectl` context for the `root` user
sudo kubectl version --short

If you get an error kubectl: command not found or there is no output for the Server Version, either connect to a Kubernetes cluster or use the Embedded Cluster Requirements.

Once you are correctly connected to the cluster, simply run the installation command:

curl -s get-rasa-x.rasa.com | sudobash

Windows & MacOS Installation

The recommended way of installing Rasa X on Windows or MacOS using the quick-install script is with Multipass. Multipass is a mini-cloud that provides a command line interface to launch and manage Ubuntu instances.

First of all, you have to download Multipass from the official website and install it. Alternatively, you can use your package manager like brew or chocolatey.

After you installed it, you can create and launch an Ubuntu instance and access it using the following commands:

multipass launch --name k3s --mem 4G --disk 50G
multipass shell k3s

Now you can use the quick-install script to install Rasa X:

curl -s get-rasa-x.rasa.com | sudobash

After you installed it, wait for Kubernetes to spin on all the instances and execute the following on your local machine to get the IP address of the running Multipass Ubuntu instance:

multipass info k3s

Use the IP4 address you’ve got to access Rasa X in your browser.

Accessing Secrets

To access auto-generated passwords later on, head over to the cluster deployment docs on Accessing Secrets. Both the release_name and namespace is rasa.

Accessing Logs

To access logs of the pods, head over to the cluster deployment docs on Accessing Logs. Both the release_name and namespace is rasa.

Uninstalling

To uninstall Rasa X, run the script with the --uninstall flag.

curl -s get-rasa-x.rasa.com | sudobash -s -- --uninstall

Next Steps