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:

One-Line Deploy Script

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

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

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 new version you want to install, 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/<rasa_x_version>/install.sh
    $ sudo bash ./install.sh
    

    replacing <rasa_x_version> with the version you want to install.

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

    $ cat .env
    
  3. After the installation is complete, log in to the Docker registry and pull the images:

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

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 new version (replace <rasa_x_version> with the version you want to install):

    Rasa X:

    $ cd /etc/rasa
    $ wget -qO docker-compose.yml https://storage.googleapis.com/rasa-x-releases/<rasa_x_version>/docker-compose.ce.yml
    $ wget -qO rasa_x_commands.py https://storage.googleapis.com/rasa-x-releases/<rasa_x_version>/rasa_x_commands.py
    

    Rasa Enterprise:

    $ cd /etc/rasa
    $ wget -qO docker-compose.yml https://storage.googleapis.com/rasa-x-releases/VERSION/docker-compose.ee.yml
    $ wget -qO rasa_x_commands.py https://storage.googleapis.com/rasa-x-releases/VERSION/rasa_x_commands.py
    
  2. Update your .env with the relevant RASA_X_VERSION, a compatible RASA_VERSION and a compatible RASA_X_DEMO_VERSION (if using).

  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
    

Openshift or Kubernetes

To upgrade the Rasa X chart to a newer version or change values for an already installed Rasa X release, you can use this command:

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

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 install a specific version (replace <rasa_x_version> with the version you want to install):

$ pip install -U pip
$ pip install rasa-x==<rasa_x_version> --extra-index-url https://pypi.rasa.com/simple