Installation requirements

The system on which you plan to install Rasa X / Enterprise must fulfill the following requirements:

Supported Operating Systems

The following operating systems are supported:

• Ubuntu (18.04/20.04)
• CentOS (7/8)
• Red Hat Enterprise Linux

Unsupported Operating Systems

• Windows: Rasa X / Enterprise is developed for Linux-based systems. The software does not run on Windows and there are no plans to add support for it.
• macOS: Running Rasa X / Enterprise on macOS is possible, but not supported.

Software Requirements

Supported Event Brokers

The following event brokers are supported:

• Kafka 2.6 or newer
• RabbitMQ 3.8.3 or newer

Database requirements

Supported Databases

The following databases are supported. Please note these requirements are only for the Rasa X / Enterprise database, see the Rasa Open Source docs for tracker store database options.

• PostgreSQL 12.8 or newer

  • PostgreSQL comes bundled with an installation of Rasa X. As a replacement for the bundled database, you can also use an external PostgreSQL database (e.g. a Google Cloud managed instance, or AWS RDS).

  • For Rasa X < 1.0.0 installations PostgreSQL 11.7 was used as default version. In the migration guide, you can learn how to migrate from PostgreSQL 11 to 12.8.

• Oracle 19

  • A database connection with Oracle has to be initialized with UTF-8 encoding, e.g. DB_URL=oracle+cx_oracle://${DB_USERNAME}:${DB_PASSWORD}@localhost:${DB_PORT}/${DB_NAME}?encoding=utf8

caution

Support for Oracle will be dropped in the future.

Database Permissions

Databases used by Rasa X / Enterprise or related services should be exclusive to these services.
Do not make direct changes to the database,
schemas, roles, or other objects except when following instructions in the
documentation.

• By default, Rasa X / Enterprise uses the public schema. This can be changed by setting the POSTGRESQL_SCHEMA environment variable.
• The database role used by Rasa X / Enterprise should be the owner of the target schema, or it should have at least the CREATE privilege on the target schema.
• The database role used by Rasa X / Enterprise should have the LOGIN, PASSWORD and INHERIT attributes.
• Rasa X / Enterprise requires read access to tables in the system catalog schema (pg_catalog). In most cases this won't need to be explicitly configured.

Hardware Requirements

Minimum Requirements / Recommended:

• Dual Core CPU / Quad Core CPU
• 8 GB RAM / 16 GB RAM
• 20 GB / 50 GB Free Disk Space

Supported Browsers

The Rasa X / Rasa Enterprise web interface aims to support
browsers that meet the following criteria:

• 0.2% market share
• not Internet Explorer
• not Opera Mini