notice

This is documentation for Rasa X Documentation v1.0.x, which is no longer actively maintained.
For up-to-date documentation, see the latest version (1.1.x).

Version: 1.0.x

Update Rasa X

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

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

To update to a newer version, choose the instructions that correspond to how you currently have Rasa X deployed:

Rasa Ephemeral Installer

You can update the Rasa X version in your values.yml by following the instructions for using a specific Rasa X version.

rasax:
tag: "1.0.1"
eventService:
tag: "1.0.1"
dbMigrationService:
tag: "1.0.1"

Helm Chart

You can update the Rasa X and Rasa Open Source versions in your values.yml file and follow the instructions for making changes to a deployment.

rasax:
# ...
tag: "1.0.1"
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.

Deprecated Installation Methods

caution

The installation methods below are deprecated and will be removed in the Rasa X 1.1 release.

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==1.0.1 --extra-index-url https://pypi.rasa.com/simple

Docker Compose

Docker Compose Install Script

note

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

  • /etc/rasa/docker-compose.yml

  • /etc/rasa/.env

  • /nginx-config-files/*

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/1.0.1/install.sh
sudo bash ./install.sh

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

    cd /etc/rasa
    cat .env

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

    cd /etc/rasa
    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

Docker Compose Manual Install

note

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

  • /etc/rasa/docker-compose.yml

  • /etc/rasa/.env

  • /nginx-config-files/*

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. Download the Rasa X and Enterprise files (docker-compose.yml and rasa_x_commands.py) for the latest version:

    cd /etc/rasa
    wget -qO docker-compose.yml https://storage.googleapis.com/rasa-x-releases/1.0.1/docker-compose.yml
    wget -qO rasa_x_commands.py https://storage.googleapis.com/rasa-x-releases/1.0.1/rasa_x_commands.py
    wget -qO nginx-config-files/nginx.conf https://storage.googleapis.com/rasa-x-releases/1.0.1/nginx-config-files/nginx.conf
    wget -qO nginx-config-files/ssl.conf.template https://storage.googleapis.com/rasa-x-releases/1.0.1/nginx-config-files/ssl.conf.template
    wget -qO nginx-config-files/rasax.nginx.template https://storage.googleapis.com/rasa-x-releases/1.0.1/nginx-config-files/rasax.nginx.template
  1. Update your .env with the relevant values:
RASA_X_VERSION=1.0.1
RASA_VERSION=2.8.15

  1. Pull the new images:

    sudo docker-compose pull

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

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