Update Rasa X¶

One-Line Deploy Script¶

If you installed Rasa X using the One-Line Deploy Script, you can update your Rasa X installation to the latest version by re-running the command which you used for the installation.

    

curl -s get-rasa-x.rasa.com | sudo bash
    
    copy
    
copied!
  

Openshift or Kubernetes¶

If you want to upgrade the Rasa X chart to the latest version or change other values for an already installed Rasa X deployment:

1. Update the Rasa X / Rasa Enterprise and Rasa Open Source versions in your values.yml file.

   # rasax specific settings
   rasax:
       # Rasa X configuration you did in previous steps
       # ...
       tag: "0.28.6"
   # rasa: Settings common for all Rasa containers
   rasa:
       # Rasa Open Source configuration you did in previous steps
       # ...
       # tag refers to the Rasa image tag
       tag: "1.10.10-full"

2. Optional: If you want to modify any further parameters of an existing deployment, do so by setting the values in your values.yml.

3. Get the release name which Helm used during the installation. If are unsure which release name was used, use the following command to find out the release name:

   helm list --namespace <your namespace>
   

4. Upgrade the deployment

   helm repo update
   helm upgrade \
       --values values.yml \
       --namespace <your namespace> \
       --reuse-values \
       <your release name> rasa-x/rasa-x
   

Docker-Compose Quick Install¶

Note

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

• /etc/rasa/docker-compose.yml

• /etc/rasa/.env

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 (if you are using Rasa Enterprise, make sure that your license is in your working directory for this step):

   curl -sSL -o install.sh https://storage.googleapis.com/rasa-x-releases/0.28.6/install.sh
   sudo bash ./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¶

Note

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

• /etc/rasa/docker-compose.yml

• /etc/rasa/.env

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 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.28.6/docker-compose.ce.yml
   wget -qO rasa_x_commands.py https://storage.googleapis.com/rasa-x-releases/0.28.6/rasa_x_commands.py

   Rasa Enterprise:

   cd /etc/rasa
   wget -qO docker-compose.yml https://storage.googleapis.com/rasa-x-releases/0.28.6/docker-compose.ee.yml
   wget -qO rasa_x_commands.py https://storage.googleapis.com/rasa-x-releases/0.28.6/rasa_x_commands.py

2. Update your .env with the relevant values:

   RASA_X_VERSION=0.28.6
   RASA_VERSION=1.10.10

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

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

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

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