Skip to Content
CLI referenceupgrade

hiveloom upgrade

Upgrades the hiveloom binary in place. Downloads the matching release artifact, swaps the binary, and restarts the service if it was running under the install script’s systemd unit.

Synopsis

hiveloom upgrade [OPTIONS]

Options

FlagDescription
--checkPrint whether an upgrade is available; do not install.
--version <VERSION>Target version (e.g. 0.3.0). Defaults to latest.
--jsonJSON output.

Examples

See whether a newer release exists:

hiveloom upgrade --check

Install the latest release:

sudo hiveloom upgrade

Pin a specific version:

sudo hiveloom upgrade --version 0.3.0

Pre-upgrade checklist

Always:

  1. hiveloom backup create --output ... — see hiveloom backup.
  2. sudo systemctl stop hiveloom — if using a manual install path.
  3. hiveloom upgrade --version <X> — replace the binary.
  4. sudo systemctl start hiveloom — restart.
  5. hiveloom health — verify.

If something goes wrong, fall back with hiveloom rollback.

Schema migrations run automatically on the next serve after the upgrade. Migrations are forward-compatible within a major version; cross- major upgrades may require an explicit migration step — read the release notes.

See also

  • Upgrade — full operations walkthrough including rollback recipes.
backuprollback