Updating Koios

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

Pull the New Image

docker pull aiopinc/koios:latest

Or pull a specific version:

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:

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:

docker stop koios
docker rm koios

Then re-run the same docker run command from Manually Starting Koios. 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:

docker pull aiopinc/koios:v1.0.0

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

Verify the Update

After restarting, check that the new version is running:

docker ps

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