Update Rasa X

Rasa X Update 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 for a compatible version.

Check Current Version

To see which version of Rasa X you are currently running, hit the /version endpoint:

curl https://example.com/api/version

Local Mode

To upgrade to the latest version of Rasa X Local mode, use these commands:

pip install -U pip
pip install -U rasa-x --extra-index-url https://pypi.rasa.com/simple

You can also specify a version to install, like so:

pip install -U pip
pip install rasa-x==0.42.6 --extra-index-url https://pypi.rasa.com/simple

Server Quick-Install

If you installed Rasa X using the quick-install script, you can update your Rasa X installation to the latest version by re-running the command that you used for the installation.

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

To update or downgrade to a specific version of Rasa X, use the RASA_X_VERSION environment variable described in the Server Quick-Install section.

Helm Chart

To upgrade the Rasa X chart to a newer version you can use this command:

helm dependency update
helm upgrade --values <path to your override file> 0.42.6 <Rasa X chart>

Alternatively, you can update the Rasa X and Rasa Open Source version in your values.yml file and follow the instructions for making changes to a deployment.

rasax:
  # ...
  tag: "0.42.6"
rasa:
  # ...
  tag: "<Rasa OS version>-full"

You can get the latest Rasa Open Source version from the bottom left corner in the Rasa Open Source Docs.

Docker Compose Install Script

Be aware that while updating, the following files will be overwritten:

Make sure there are no changes in these files that you still need. This means that instead of directly modifying docker-compose.yml to e.g. add a custom channel volume or custom action server image, you should rather create a new file called docker-compose.override.yml. Docker will automatically take that file into account and override any attributes in docker-compose.yml with changes from the override file.

  1. To install an update, fetch the install.sh for the latest version, and run it:

    curl -sSL -o install.sh https://storage.googleapis.com/rasa-x-releases/0.42.6/install.sh
sudobash ./install.sh

  2. Make sure that the Docker environment file is updated with the newly installed versions by running:

    cd /etc/rasa
cat .env

  3. After the installation is complete, pull the images:

    cd /etc/rasa
sudo docker-compose pull

  4. Bring down your running Rasa X instance and start the updated version:

    sudo docker-compose down
sudo docker-compose up -d

Docker Compose Manual Install

Be aware that while updating, the following files will be overwritten:

  1. Download the Rasa X files (docker-compose.ce.yml and rasa_x_commands.py) for the latest version: Rasa X:
    cd /etc/rasa
wget -qO docker-compose.yml https://storage.googleapis.com/rasa-x-releases/0.42.6/docker-compose.ce.yml
wget -qO rasa_x_commands.py https://storage.googleapis.com/rasa-x-releases/0.42.6/rasa_x_commands.py
wget -qO nginx-config-files/nginx.conf https://storage.googleapis.com/rasa-x-releases/0.42.6/nginx-config-files/nginx.conf
wget -qO nginx-config-files/ssl.conf.template https://storage.googleapis.com/rasa-x-releases/0.42.6/nginx-config-files/ssl.conf.template
wget -qO nginx-config-files/rasax.nginx.template https://storage.googleapis.com/rasa-x-releases/0.42.6/nginx-config-files/rasax.nginx.template

Rasa Enterprise:

cd /etc/rasa
wget -qO docker-compose.yml https://storage.googleapis.com/rasa-x-releases/0.42.6/docker-compose.ee.yml
wget -qO rasa_x_commands.py https://storage.googleapis.com/rasa-x-releases/0.42.6/rasa_x_commands.py
wget -qO nginx-config-files/nginx.conf https://storage.googleapis.com/rasa-x-releases/0.42.6/nginx-config-files/nginx.conf
wget -qO nginx-config-files/ssl.conf.template https://storage.googleapis.com/rasa-x-releases/0.42.6/nginx-config-files/ssl.conf.template
wget -qO nginx-config-files/rasax.nginx.template https://storage.googleapis.com/rasa-x-releases/0.42.6/nginx-config-files/rasax.nginx.template

  1. Update your .env with the relevant values:

    RASA_X_VERSION=0.42.6
RASA_VERSION=2.8.14

  2. Pull the new images:

    # If you are using Rasa Enterprise, log in to the private Docker registry
sudo docker login -u _json_key -p "$(cat /etc/rasa/gcr-auth.json)" https://gcr.io
# Pull the new images
sudo docker-compose pull

  3. Bring down your running Rasa X instance and start the updated version:

    sudo docker-compose down
sudo docker-compose up -d