KoaVM
Guide pages

Guide · For administrators

Updates and versions

What's new

The What's new page lists every version with its date and what changes, for you and for your customers. The same list is on koavm.com/en/changelog. Numbers follow the x.y.z rule: z changes for fixes and small additions, y for new features, x for big changes.

Updating from the panel

Every 6 hours the panel checks for a new version on the stable channel (https://koavm.com/releases/stable.json). When there is one, What's new shows the version, what changes and the Update now button. Once pressed:

  1. the panel downloads the version and checks its signature (only versions signed by Prime Software are accepted) and its SHA-256;
  2. the koavm-update system service repeats the same checks, makes a copy of the database (/var/lib/koavm/koavm-prima-VERSION.db) and replaces the binary, keeping the previous one;
  3. the panel restarts (a few seconds without the interface; VPSs keep running);
  4. if the new version does not start within 90 seconds, the previous one comes back on its own.

The page reloads by itself at the end. Go back to the previous version puts the previous version back (the database stays as it is now; the copy made before the update stays in the data folder).

The automatic check can be turned off on the same page.

From the command line

sudo koavm update --check      # tells whether there is a new version and what changes
sudo koavm update              # updates (same checks and same database copy)
sudo koavm update --rollback   # goes back to the previous version

If the panel was installed before 0.7.2

The koavm-update service is installed by install.sh. Update once with the script (see Installation) or with sudo koavm update: from then on updates are done from the panel.