# Rasa Ephemeral Installer Documentation

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

## 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 Enterprise without a Rasa Open Source server. To connect a Rasa Open Source server, see the [Connect Rasa Open Source to Rasa Enterprise](https://legacy-docs-enterprise.rasa.com/docs/rasa-enterprise/1.1.x/installation-and-setup/deploy-tools/connect-rasa-to-rasa-enterprise) section. You can learn more about `rasactl` in the [rasactl CLI docs](https://legacy-docs-enterprise.rasa.com/docs/rasa-enterprise/1.1.x/installation-and-setup/deploy-tools/rasactl) section.

The [Quickstart](https://legacy-docs-enterprise.rasa.com/docs/rasa-enterprise/1.1.x/installation-and-setup/deploy-tools/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.1.x/installation-and-setup/post-deploy-steps/set-up-ivc). To start Rasa Enterprise with a local Rasa project mounted, see [Starting Rasa Enterprise with a Local Rasa Project](https://legacy-docs-enterprise.rasa.com/docs/rasa-enterprise/1.1.x/installation-and-setup/deploy-tools/rasa-ephemeral-installer/installation/#starting-rasa-x-with-a-local-rasa-project).

## Quickstart

1. Download and run Rasa Ephemeral Installer:

```bash
   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:

```bash
   $ rasactl start
   ```

By default, `rasactl` will deploy the latest stable release of Rasa Enterprise. To use the latest edge release of Rasa Enterprise, run the following instead:

```bash
   rasactl start --rasa-x-edge-release
   ```

3. Check the status of your deployment.

```bash
   $ rasactl status
   ```
   - Name: pink-moldorf
   - Status: Running
   - URL: http://pink-moldorf.rasactl.localhost
   - Version: 1.1.3
   - 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 Enterprise in a web browser. From there you can connect Rasa Enterprise to your bot's git repository.

## Starting Rasa Enterprise with a Local Rasa Project

Starting a Rasa Enterprise deployment with a local Rasa project is supported for Rasa 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 Enterprise

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

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

```bash
   $ 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:

```bash
   $ rasactl status
   ```
   - Name: hungry-lewin
   - Status: Running
   - URL: http://hungry-lewin.rasactl.localhost
   - Version: 1.1.3
   - 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 Enterprise deployment](https://legacy-docs-enterprise.rasa.com/docs/rasa-enterprise/1.1.x/installation-and-setup/connect-rasa-to-rasa-enterprise).
- [Learn more about `rasactl`](https://legacy-docs-enterprise.rasa.com/docs/rasa-enterprise/1.1.x/installation-and-setup/deploy-tools/rasactl).