This installation method is deprecated and will be removed with Rasa X 1.1 release.
MacOS and Linux Installation
You can install Rasa X on your local machine with:
installing edge vs. stable
The above command will install the stable version of Rasa X. To install the latest edge version, use:
From your Rasa assistant's project directory, start it with
This should open a browser tab to
- WLS 2 (Windows Subsystem for Linux)
- Docker with WSL2 backend
To configure Docker with WSL2 backend, please follow this guide.
WSL 2 provides a Linux shell on Windows. You can use either PowerShell or Linux Shell to launch Rasa X local mode.
The Docker solution only supports Windows with WSL2 enabled. For Windows Server and Windows desktop which don't support WSL2, please check out other installation methods.
Run using Docker
From your Rasa assistant's project directory, start Rasa X with
- Windows PowerShell
This should give you a URL to Rasa X. Copy the URL and open it with your browser.
By default, Rasa X will auto-generate a password for you that will be available in the
logs. You can set a specific password for Rasa X via the
RASA_X_PASSWORD environment variable.
The following arguments can also be used to adapt the server settings:
Share your bot in local mode
You can download and install ngrok for free. Once it is installed, open a new terminal window and run:
This will create a public HTTPS url for your locally running Rasa X server, given that it is running at the default port (if not, change the command above).
You should see something like this:
To share your bot, replace the
http://localhost:5002 portion of your Share your Bot link with
the https forwarding address from ngrok. Your link should then look something like this:
From there you can follow the instructions for sharing your bot
Keep in mind that ngrok has limits on free usage and this is not a production set up.