---
title: "Updating Koios"
description: "How to upgrade Koios to a new version"
source_url: https://ai-ops.com/docs/updates/general
---

# Updating Koios

Koios updates are delivered as new Docker image versions. Your data is stored in Docker volumes, so it is preserved across updates.

> [!TIP] Back Up First
> Before upgrading, create a backup in case you need to roll back. The easiest way is from **System > Backup** in the web interface — see [Backup & Restore](https://ai-ops.com/docs/system/backup.md). For command-line backups, see [Backing Up Docker Volumes](https://ai-ops.com/docs/installation/backup-restore.md).

> [!WARNING] Check the Migration Guide
> Major version upgrades (e.g. v0.10.x to v1.0.0) may require changes to your service file or Docker run command. Always check the migration guide for your target version before upgrading.

## Pull the New Image

```bash
docker pull aiopinc/koios:latest
```

Or pull a specific version:

```bash
docker pull aiopinc/koios:v1.0.0
```

## Update: Systemd Service

If you're running Koios as a systemd service, pull the new image first, then restart the service:

```bash
sudo systemctl restart docker.koios.service
```

The service will automatically stop the old container and start a new one with the updated image.

## Update: Manual Docker Run

If you're running Koios manually, stop and remove the old container, then start a new one:

```bash
docker stop koios
docker rm koios
```

Then re-run the same `docker run` command from [Manually Starting Koios](https://ai-ops.com/docs/installation/manually-starting-koios.md). Your data persists in the Docker volumes.

## Downgrade to a Previous Version

To roll back to a specific version, pull that version's tag and restart:

```bash
docker pull aiopinc/koios:v1.0.0
```

Then update the service file or `docker run` command to reference the specific tag instead of `latest`.

> [!WARNING] Database Migrations
> Newer Koios versions may include database migrations that run automatically on startup. After downgrading, the database schema may be newer than the software expects. If the version gap is too large, the container will log a "Schema version incompatible" error and exit. Restore from a backup taken before the upgrade to resolve this.

## Verify the Update

After restarting, check that the new version is running:

```bash
docker ps
```

You can also verify the version from the Koios web interface under **System > Overview**.