SYSUPGRADE(8) | System Manager's Manual | SYSUPGRADE(8)

# NAME

`sysupgrade` — upgrade system to the next release or a new snapshot

# SYNOPSIS

`sysupgrade` | [`-fkns`] [`-b` base-directory] [`-R` version] [installurl | path]

# DESCRIPTION

`sysupgrade` is a utility to upgrade OpenBSD to a new release or snapshot if available.

`sysupgrade` downloads the necessary files to /home/_sysupgrade, verifies them with signify(1), and copies bsd.rd to /bsd.upgrade.

`sysupgrade` by default then reboots the system. The bootloader will automatically choose /bsd.upgrade, triggering a one-shot upgrade using the files in /home/_sysupgrade.

The options are as follows:

`-b` base-directory
  Download files to base-directory/_sysupgrade instead of /home/_sysupgrade.
`-f`
  For snapshots, force an already applied upgrade. This option has no effect on releases.
`-k`
  Keep the files in /home/_sysupgrade. By default they will be deleted after the upgrade.
`-n`
  Fetch and verify the files and create /bsd.upgrade but do not reboot.
`-R` version
  Upgrade to a specific release version. Only upgrades from one version to the next are tested. Skipping versions may work. Downgrading is unlikely to work.
`-s`
  Upgrade to a snapshot. The default is to upgrade to the next release.

When updating to a release or snapshot which lacks the required signify keys in /etc/signify, the missing keys will be downloaded in a secure way. In the usual case, the keys will already be present because OpenBSD releases ship with the current key, the next key, and a collection of older keys.

See upgrade.site(5) for how to customize the upgrade process.

# FILES

/auto_upgrade.conf
  Response file for the ramdisk kernel.
/bsd.upgrade
  The ramdisk kernel to trigger an unattended upgrade.
/etc/installurl
  OpenBSD mirror top-level URL for fetching an upgrade.
/home/_sysupgrade
  Directory the upgrade is downloaded to.

# SEE ALSO

signify(1), installurl(5), upgrade.site(5), autoinstall(8), release(8), sysmerge(8)

# HISTORY

`sysupgrade` first appeared in OpenBSD 6.6.

October 25, 2024 | Debian