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

# Upgrades

> Update a self-hosted Cymph deployment to a newer release.

# Before you begin

Take a backup of the database and API volumes before you begin the update process — the stack has to be stopped for the upgrade anyway, which is the same window a consistent snapshot needs. See [Backup & restore](/deployment/self-hosted/backup-restore).

Check that the host has room for the new images. The pull downloads a complete new set before the old ones are released, so the upgrade needs headroom for both versions at once:

```
df -h /var/lib/docker
sudo docker system df
```

# Steps

1. Stop the current running containers

```
sudo docker compose stop
```

2. Update the container images

```
sudo docker compose pull
```

<Note>
  If this step fails with `no space left on device`, the host has run out of room — usually because images from previous releases have accumulated. See [Upgrade fails with "no space left on device"](/deployment/self-hosted/troubleshooting#upgrade-fails-with-no-space-left-on-device) for how to reclaim it safely. The running deployment is unaffected, and the pull can be repeated.
</Note>

3. Re-create and start the containers

```
sudo docker compose up -d --force-recreate
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.