Upgrading to v1.1.0

Koios v1.1.0 supports a direct upgrade from both v1.0.x and v0.10.x. Database migrations run automatically the first time the new container starts, and the entrypoint takes an automatic backup before migrating. Before you begin, follow the general update procedure to pull the new image and restart the service.

Back up first

The entrypoint saves a pre-migration database backup automatically, but a full volume backup before any upgrade is still the safest practice.

From v1.0.x

This is a drop-in upgrade. No volume or configuration changes are needed:

Pull the new image and restart the service, following Updating Koios.
Migrations run automatically on first boot.
Confirm the new version under System > Overview.

Your existing devices, tags, models, and bindings carry forward. Binding calibration is off by default, so existing bindings behave exactly as before until you set a gain or bias.

From v0.10.x

A v0.10.x upgrade needs the same one-time change introduced in v1.0.0: the koios_secrets volume must be mounted so runtime secrets are generated and preserved across restarts. Complete the v1.0.0 migration steps to add the seventh volume mount to your service file, then proceed with the standard update. Your existing credentials are detected and preserved.

The secrets volume is required

Starting with v1.0.0, the container refuses to start if any of its seven volume mounts is missing and logs FATAL: Required Docker volume mounts missing. Make sure koios_secrets is mounted before you start the new image. See Migrating to v1.0.0 for the exact mount.

After Upgrading

Confirm the version under System > Overview.
Check System > Service Status to verify every service is running.
Review the v1.1.0 release notes for new features.

What's Next

Updating Koios: the general update procedure for any version.
v1.1.0 Release Notes: everything new in this release.
Backing Up Docker Volumes: back up before you upgrade.

Updating Koios Migrating to v1.0.0