Quick-Installation¶

Hardware & OS Requirements¶

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

• Ubuntu 16.04 / 18.04

• Debian 9 / 10

• Red Hat 7 / 8

• CentOS 7 / 8

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

• Minimum: 2 vCPUs

• Recommended: 2-6 vCPUs

RAM

• Minimum: 4 GB RAM

• Recommended: 8 GB RAM

Disk Space

• Recommended: 50 GB disk space available

Supported Browsers¶

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

• > 0.2% market share

• not Internet Explorer

• not Opera Mini

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 | sudo bash

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 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

# The output should be similar to this
# Client Version: v1.17.3+k3s1
# Server Version: v1.17.3+k3s1

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 | sudo bash

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 | sudo bash

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.