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

# Upgrades

> Upgrading your Omni instance to a new version

## Docker Compose

If you haven't already, set up the alias:

```bash theme={null}
alias omni-compose="docker compose -f docker/docker-compose.yml --env-file .env"
```

### Upgrade to Latest

Pull the latest images and restart:

```bash theme={null}
omni-compose pull
omni-compose up -d
```

Database migrations run automatically on startup.

### Pin a Specific Version

To pin all Omni services to a specific release, set `OMNI_VERSION` in your `.env` file:

```bash theme={null}
OMNI_VERSION=0.1.4
```

Then pull and restart:

```bash theme={null}
omni-compose pull
omni-compose up -d
```

When `OMNI_VERSION` is unset, all services default to `latest`.

<Tip>
  Pinning a version is recommended for production deployments to avoid unexpected changes during restarts.
</Tip>

## AWS (Terraform)

Force a redeployment of the ECS tasks to pull the latest images:

```bash theme={null}
aws ecs update-service --cluster omni --service omni-web --force-new-deployment
aws ecs update-service --cluster omni --service omni-indexer --force-new-deployment
aws ecs update-service --cluster omni --service omni-ai --force-new-deployment
aws ecs update-service --cluster omni --service omni-searcher --force-new-deployment
```

Repeat for any connector services you have running.