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).

To see which version of Rasa X you are currently running, hit the `/version` endpoint:

```bash
curl https://example.com/api/version
```

To update to a newer version, choose the instructions that correspond to how you currently have Rasa X deployed:

## Rasa Ephemeral Installer

You can update the Rasa X version in your `values.yml` by following the [instructions for using a specific Rasa X version](https://legacy-docs-enterprise.rasa.com/docs/rasa-enterprise/1.0.x/installation-and-setup/install/rasa-ephemeral-installer/configuration#use-a-specific-rasa-x--enterprise-version).

```yaml
rasax:
  tag: "1.0.4"

eventService:
  tag: "1.0.4"

dbMigrationService:
  tag: "1.0.4"
```

## Helm Chart

You can update the Rasa X and Rasa Open Source versions in your `values.yml` file and follow the [instructions for making changes to a deployment](https://legacy-docs-enterprise.rasa.com/docs/rasa-enterprise/1.0.x/installation-and-setup/customize#making-changes-to-the-deployment).

```yaml
rasax:
  # ...
  tag: "1.0.4"
rasa:
  # ...
  tag: "<Rasa OS version>-full"
```

You can get the latest Rasa Open Source version from the bottom left corner in the [Rasa Open Source Docs](/content/docs/rasa/index.html).

## Deprecated Installation Methods

The installation methods below are deprecated and will be removed in the Rasa X 1.1 release.

### Local Mode

To upgrade to the latest version of Rasa X Local mode, use these commands:

```bash
pip install -U pip
pip install -U rasa-x --extra-index-url https://pypi.rasa.com/simple
```

You can also specify a version to install, like so:

```bash
pip install -U pip
pip install rasa-x==1.0.4 --extra-index-url https://pypi.rasa.com/simple
```

### Docker Compose

#### Docker Compose Install Script

Be aware that while updating, the following files will be overwritten:
- `/etc/rasa/docker-compose.yml`
- `/etc/rasa/.env`
- `/nginx-config-files/*`

Make sure there are no changes in these files that you still need. This means that instead of directly modifying `docker-compose.yml` to e.g. add a custom channel volume or custom action server image, you should rather create a new file called `docker-compose.override.yml`. Docker will automatically take that file into account and override any attributes in `docker-compose.yml` with changes from the override file.

1. To install an update, fetch the `install.sh` for the latest version, and run it:

```bash
curl -sSL -o install.sh https://storage.googleapis.com/rasa-x-releases/1.0.4/install.sh
sudo bash ./install.sh
```

2. Make sure that the Docker environment file is updated with the newly installed versions by running:

```bash
cd /etc/rasa
cat .env
```

3. After the installation is complete, pull the images:

```bash
cd /etc/rasa
sudo docker-compose pull
```

4. Bring down your running Rasa X instance and start the updated version:

```bash
sudo docker-compose down
sudo docker-compose up -d
```

#### Docker Compose Manual Install

Be aware that while updating, the following files will be overwritten:
- `/etc/rasa/docker-compose.yml`
- `/etc/rasa/.env`
- `/nginx-config-files/*`

1. Download the Rasa X and Enterprise files (`docker-compose.yml` and `rasa_x_commands.py`) for the latest version:

```bash
cd /etc/rasa
wget -qO docker-compose.yml https://storage.googleapis.com/rasa-x-releases/1.0.4/docker-compose.yml
wget -qO rasa_x_commands.py https://storage.googleapis.com/rasa-x-releases/1.0.4/rasa_x_commands.py
wget -qO nginx-config-files/nginx.conf https://storage.googleapis.com/rasa-x-releases/1.0.4/nginx-config-files/nginx.conf
wget -qO nginx-config-files/ssl.conf.template https://storage.googleapis.com/rasa-x-releases/1.0.4/nginx-config-files/ssl.conf.template
wget -qO nginx-config-files/rasax.nginx.template https://storage.googleapis.com/rasa-x-releases/1.0.4/nginx-config-files/rasax.nginx.template
```

2. Update your `.env` with the relevant values:

```bash
RASA_X_VERSION=1.0.4
RASA_VERSION=2.8.31
```

3. Pull the new images:

```bash
sudo docker-compose pull
```

4. Bring down your running Rasa X instance and start the updated version:

```bash
sudo docker-compose down
sudo docker-compose up -d
```