You are viewing documentation for a legacy Rasa product. If you want to get started building assistants with Rasa please check out our latest [documentation here](/content/docs/index.html).

This page describes how to use Rasa Ephemeral Installer to install Rasa X.

## Before You Start

You will need `sudo` access on your machine to use REI for installation. The installer will prompt you for your password.

REI installs `rasactl`. `rasactl` deploys Rasa X without a Rasa Open Source server. To connect a Rasa Open Source server, see the [Connect Rasa Open Source to Rasa X](https://legacy-docs-enterprise.rasa.com/docs/rasa-enterprise/1.0.x/installation-and-setup/connect-rasa-to-rasa-x) section. You can learn more about `rasactl` in the [Command Line Interface](https://legacy-docs-enterprise.rasa.com/docs/rasa-enterprise/1.0.x/installation-and-setup/install/rasa-ephemeral-installer/command-line-interface) section.

The [Quickstart](https://legacy-docs-enterprise.rasa.com/docs/rasa-enterprise/1.0.x/installation-and-setup/install/rasa-ephemeral-installer/installation/#quickstart) section assumes you will be [connecting to a remote Git repository](https://legacy-docs-enterprise.rasa.com/docs/rasa-enterprise/1.0.x/installation-and-setup/deploy#integrated-version-control). To start Rasa X with a local Rasa project mounted, see [Starting Rasa X with a Local Rasa Project](https://legacy-docs-enterprise.rasa.com/docs/rasa-enterprise/1.0.x/installation-and-setup/install/rasa-ephemeral-installer/installation/#starting-rasa-x-with-a-local-rasa-project).

## Quickstart

1. Download and run Rasa Ephemeral Installer:

```
   curl -O https://rei.rasa.com/rei.sh && bash rei.sh -y
   ```

The command above will prepare the environment and install the following components:

- [docker](https://www.docker.com/)
   - [kind](https://kind.sigs.k8s.io/docs/user/quick-start/)
   - [helm](https://helm.sh/)
   - [kubectl](https://kubernetes.io/docs/reference/kubectl/overview/)
   - [rasactl](https://github.com/RasaHQ/rasactl)

2. Use `rasactl` to deploy Rasa:

```
   $ rasactl start
   ```

By default, `rasactl` will deploy the latest stable release of Rasa X. To use the latest edge release of Rasa X, run the following instead:
   
   ```
   rasactl start --rasa-x-edge-release
   ```

3. Check the status of your deployment.

```
   $ rasactl status
   ```

Name: pink-moldorf
   
   Status: Running
   
   URL: http://pink-moldorf.rasactl.localhost
   
   Version: 1.0.4
   
   Enterprise: active
   
   Rasa production version: 0.0.0
   
   Rasa worker version: 0.0.0
   
   Project path: not defined

4. Use the `rasactl open` command to view Rasa X in a web browser. From there you can connect Rasa X to your bot's git repository.

## Starting Rasa X with a Local Rasa Project

Starting a Rasa X deployment with a local Rasa project is supported for Rasa X / Enterprise ≥ 1.0.0.

### Requirements

1. `kind`. Using a local Rasa project is only supported with `kind` as the k8s platform. `kind` is installed along with other tools if you use the REI to install all components.

2. A local Rasa project. If you don't have one yet, there are two easy ways to create a Rasa project:
   
   - use the [`rasa init`](/content/docs/rasa/command-line-interface#rasa-init/index.html) command.
   - use the [Rasa Playground](/content/docs/rasa/playground/index.html) to create and download a project.

### Starting Rasa X

After [downloading and installing REI](https://legacy-docs-enterprise.rasa.com/docs/rasa-enterprise/1.0.x/installation-and-setup/install/rasa-ephemeral-installer/installation/#quickstart):

1. Start Rasa X in your local Rasa project directory:

```
   $ cd <rasa-project-dir>
   $ rasactl start --project
   ```

You can use the `--project-path` flag to define a Rasa project directory explicitly, in which case you don't have to run the command from your project directory.

2. Check the status of your deployment - it should reflect your local project path:

```
   $ rasactl status
   ```

Name: hungry-lewin
   
   Status: Running
   
   URL: http://hungry-lewin.rasactl.localhost
   
   Version: 1.0.4
   
   Enterprise: inactive
   
   Rasa production version: 0.0.0
   
   Rasa worker version: 0.0.0
   
   Project path: /path/to/rasa_project

## Next Steps

- [Connect a Rasa Open Source server to a Rasa X deployment](https://legacy-docs-enterprise.rasa.com/docs/rasa-enterprise/1.0.x/installation-and-setup/connect-rasa-to-rasa-x).
- [Learn more about `rasactl`](https://legacy-docs-enterprise.rasa.com/docs/rasa-enterprise/1.0.x/installation-and-setup/install/rasa-ephemeral-installer/command-line-interface).