notice

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

Version: 1.2.x

Version Migration Guide

This page contains information about changes between Rasa Enterprise versions and how you can migrate from one version to another.

Rasa Enterprise 1.1 to 1.2

Version 1.2 of Rasa Enterprise is compatible with Rasa Open Source 3.x (at the time of writing, 3.0, 3.1 and 3.2).

Development Environment Configuration

As part of our deprecation process, we have removed support for the configuration of deployment environments using environments.yml. Environments should be configured in the UI going forward. Any changes made to your environments.yml file will not be picked up anymore and should be made using the Rasa Enterprise UI.

We recommend to delete the environments.yml to avoid any confusion - its content is stored in Rasa Enterprise and can be changed using the UI.

Rasa Enterprise 1.0 to 1.1

Version 1.1 of Rasa Enterprise adds compatibility with Rasa Open Source 3.0. Rasa Open Source 2 data and models are no longer supported. This means that the following data formats are now incompatible and will be rejected by Rasa Enterprise:

  • Stories / NLU data in Markdown format
  • NLU data in Rasa JSON format
  • Lookup Tables as text files
  • Any training data in Rasa YAML 2.0 format.

Steps to Upgrade

  1. Make sure that you have pushed or discarded your pending annotations. After this, Integrated Version Control should be in a green state.

  2. Migrate your Rasa Open Source project data to Rasa Open Source 3.0:

    • Convert potential Markdown data to Rasa YAML 3.0 format
    • Convert lookup tables in text files to Rasa YAML 3.0 format
    • Convert data in Rasa YAML 2.0 format to Rasa YAML 3.0.

    Please follow the Rasa Open Source 3.0 migration guide for detailed instructions on how to convert the training data.

  3. Use these instructions to update your deployment.

Integrated Version Control and Incompatible Projects

Integrated Version Control will refuse to connect to Git branches which contain incompatible project data. Integrated Version Control will also disconnect from the Git server if you upgrade to Rasa Enterprise 1.1 while being connected to a branch with incompatible project data.

Convert incompatible Rasa 2.0 project data to Rasa YAML 3.0 format to be able to reconnect your repository to Rasa Enterprise.