> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dittofeed.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upgrading from v0.11.0 to v0.12.1

Upgrading from v0.11.0 to v0.12.1 is fairly straightforward. This guide will walk you through the process of upgrading your Dittofeed instance.

## Step 1: Setting Up Your `docker-compose.lite.yaml` File

First, add the environment variable `BOOTSTRAP: "false"` to your `docker-compose.lite.yaml` file, if it isn't set already. This will prevent your lite instance from running bootstrap operations when it restarts.

Next, make sure you have an `admin-cli` instance specified in our `docker-compose.lite.yaml` file. We'll be using this service to run our migrations.

Your `docker-compose.lite.yaml` file should look something like this:

```yaml theme={null}
...
services:
  lite:
    image: dittofeed/dittofeed-lite:${IMAGE_TAG:-v0.11.0}
    restart: always
    ports:
      - "3000:3000"
    depends_on:
      - postgres
      - temporal
      - clickhouse-server
    environment:
      <<: *backend-app-env
      # uncomment while upgrading dittofeed
      BOOTSTRAP: "false"
    env_file:
      - .env
    networks:
      - dittofeed-network-lite
  # useful for upgrading dittofeed
  admin-cli:
    image: dittofeed/dittofeed-lite:${IMAGE_TAG:-v0.12.1}
    entrypoint: []
    profiles: ["admin-cli"]
    command: tail -f /dev/null
    tty: true
    depends_on:
      - postgres
      - temporal
      - clickhouse-server
    environment:
      <<: *backend-app-env
    env_file:
      - .env
    networks:
      - dittofeed-network-lite
...
```

## Step 2: Start the `admin-cli` Service

Next, run the following command to start your `admin-cli` service:

```bash theme={null}
docker compose --profile admin-cli -f docker-compose.lite.yaml up admin-cli -d
```

## Step 3: Run the Upgrade Script

Run the upgrade script before deploying the new version of Dittofeed:

```bash theme={null}
./scripts/admin-lite.sh upgrade-0-12-1-pre
```

## Step 4: Upgrade Your `docker-compose.lite.yaml` File

Upgrade the version in your docker-compose.lite.yaml file to v0.12.1:

```yaml theme={null}
...
services:
  lite:
    image: dittofeed/dittofeed-lite:${IMAGE_TAG:-v0.12.1}
...
```

Now restart your lite instance:

```bash theme={null}
docker compose -f docker-compose.lite.yaml up lite -d --force-recreate
```

## Step 5: Stop the `admin-cli` Service

Finally, stop the `admin-cli` service:

```bash theme={null}
docker compose --profile admin-cli -f docker-compose.lite.yaml stop admin-cli
```
