Skip to Content

Updates

The launcher has two separate kinds of update: updates of the launcher itself, and updates of the products it installs. Both are signed, and neither is installed without you choosing it.

Not yet verified

A launcher updating itself from a published release has not been verified yet. The update checks are covered by the launcher’s own tests on macOS; the Windows installer hand-off has not been run on a real PC.

Launcher updates

How a launcher update is found

  • The launcher checks 30 seconds after it starts, then every six hours while it is open.
  • You can check at any time with Check for launcher updates in the top bar.
  • A check only looks. It never downloads or installs the update.

Hover over the button to see the version you are running.

Install a launcher update

Wait for the update to be offered

When a newer version exists, the button reads Install launcher update followed by the version. Below it the launcher reminds you: Windows installer closes the launcher. On macOS/Linux, reopen when ready.

Choose Install launcher update

The button reads Downloading update…. The launcher downloads the update and checks its signature before it writes anything.

Finish

The launcher shows Update ready. Restart Unrest manually to finish. Quit Unrest and open it again when you are ready. The launcher does not restart by itself.

What the launcher checks

CheckDetail
AddressThe update is an HTTPS file in the Unrest releases repository, stored under a fixed version, not under the beta channel itself.
SignatureThe update must carry a valid Minisign signature made with the Unrest updater key. The public key is built into the launcher. An unsigned or changed file is never installed.
VersionThe signature names the version it was made for. It must match the version the channel announces, so an old update cannot be relabelled as a new one.
No downgradeThe launcher does not install a version that is the same as or older than the one installed.

On macOS the new app replaces the old one in a single step, so the app in place is always either the complete old version or the complete new one. The previous app is kept beside it as a hidden folder named .Unrest.previous-<id>.app. The launcher does not delete it.

The button states

Button or messageMeaning
Check for launcher updatesNo update is known. Choose it to check now.
Checking updates…A check is running.
Install launcher update 1.2.3A newer version is available.
Downloading update…The update is being downloaded and checked.
Update ready. Restart Unrest manually to finish.The update is installed. Reopen the launcher.
Updates unavailableThis build of the launcher has no update key, so it never checks. This is the case for unsigned test builds.

The beta channel

The open beta has one update channel, named beta. Installed launchers read one fixed file, latest.json, from the release named Beta channel on the releases page. That file names the newest launcher version and points to the files of that version’s own release.

Publishing a new versioned release does not by itself change the channel. Your launcher sees a new version once the channel file has been updated to name it.

Product updates

The versions of each product are built into the launcher. This has two consequences:

  • When the launcher you run knows a newer GameGen than the one installed, GameGen’s state is Update available and its button reads Update. The line under the button reads, for example, Installed 1.2.3 · 1.3.0 available.
  • A new GameGen version reaches you through a new launcher version. Update the launcher first; the newer GameGen is offered afterwards.

Update a product

Update the launcher

Install any launcher update that is offered, and reopen the launcher.

Open the product

Find the product in the Library. Its state is Update available.

Choose Update

The update is downloaded, checked and installed exactly like a first installation. See what the launcher checks.

The new version is installed beside the old one. The old version stays on disk and is not changed, so a copy of the product that is still running keeps working.

GameGen cannot ask the launcher to update it, and the launcher does not run in the background. Open the launcher from time to time to see whether an update is offered.

Next steps

Last updated on