Skip to content

The desktop app updates itself and the daemon beside it only from a release the release key signed, follows the plane's recommended version and says its update_required, and asks before it restarts; the terminal says the plane's suggest in a line

Decision 874 · accepted · 2026-10-12 · issue #66

The maintainer decided the shape on 2026-10-12: the release minisign key also signs the desktop app's update, so there is one key and one rotation story; the desktop app updates itself, and the daemon it runs, only from a signed release; it follows the plane's recommended version when signed in, never a blocked one and never below the minimum; it asks the person before it restarts; and it calls the plane's initialize and shows update_required as a sentence.

One key: Tauri's updater takes the release key as it is

Tauri's updater checks an update with minisign, through the minisign-verify crate: its public key is minisign's .pub file, base64-encoded, and an update's signature is a minisign signature, base64-encoded, read as minisign reads one, hashed (ED) or not. The release key is a minisign key (Decision 865), so the updater takes it with nothing to convert and no second key is needed. What Tauri's own tools add — a password on the secret key, tauri signer sign — is not used: the signature is made by the same Elixir signer that signs the manifest (Troupe.Release.Minisign), in the publish job, which alone holds the key. The trusted comment names the file and the version (version:0.15.0-beta), which the updater holds the version it is offered to, so an older signed update served under a newer number is refused by the updater too.

What a release carries

The script refuses as the manifest's does: no key, an encrypted key, or a key that is not the first in release-keys.txt, and the release stays a draft.

A key rotation. The updater checks one key, the first block of a signature. The apps that update to a rotation release were built before it and trust the old key alone, and an app built from it trusts both, so during a rotation the update is signed with RELEASE_MINISIGN_KEY_PREVIOUS, the key being retired, and with the current key otherwise. The app gives the updater whichever of its own compiled-in keys made the signature.

What the app checks, and in what order

src-tauri/src/release.rs is the Elixir verifier's twin, held to the same answers by the shared vectors in test/fixtures/release/, and trusts the keys release-keys.txt held when the app was compiled, and no others: tauri.conf.json's plugins.updater.pubkey is empty on purpose, so nothing but update.rs, which names the key for each update, can make the updater accept one. update_check fetches the release's manifest.json and its signature first and nothing else until the signature holds and the manifest names the version asked for (or the tag /releases/latest named); then the update's .sig, held to the manifest's size and sha256. update_download has the updater download and check the update against that key, and checks it again against the manifest's size and sha256. A release that fails any of it is refused with a sentence, and nothing changes. The page is granted none of the updater plugin's own commands, and the shell's three take no URL, path or key from it.

Where from. Signed in to a plane, the version me.client_versions recommends for desktop; otherwise, or with none recommended, the latest release. TROUPE_RELEASE_URL and TROUPE_REPO move it as they move troupe update; over https only, since the updater reads nothing else in a release build. The download is from wherever the manifest was found, not the URL latest.json names. A version the plane blocks, or one below its minimum, is never installed; nothing older than the app is offered, and on a blocked version whose recommended one is older the app says so and leaves the move back to the person (Decision 868's rule).

When it checks, and when it restarts

On start and once a day: the plane's initialize (as troupe-gui, with the version as releases are numbered, not the bundle's numeric one), then the release check, which waits for the plane's answer so that it never offers a version the plane would not serve. Nothing is downloaded until the person presses Update, and nothing restarts until they press Restart now. Then the app waits for every turn at work in a session on this computer; a team session runs on its pod whatever the window does, and is not waited for. On Windows the setup restarts the app (Tauri's /R); elsewhere the app restarts into the new bundle.

The daemon beside the app

The desktop app does not carry a daemon inside its bundle: the installers put troupe-daemon beside it (%LOCALAPPDATA%\Programs\troupe-daemon, ~/.local/lib/troupe-daemon, TROUPE_LIB_DIR). So the update replaces that one, from the same verified release, where it is older than the release and the plane serves the release's daemon. Its archive is checked against the manifest and unpacked beside it as troupe-daemon.new; before the install the page asks the daemon to stop between turns with daemon.stop, asking again every two seconds while it names a turn at work (Decision 865's rule), and the shell waits for it to be gone, then renames it to troupe-daemon.previous and the new one into its place: the installers' names, so troupe update --rollback and install-local.ps1 -Rollback find them. If the app's own install fails after that, the daemon goes back as it was. A daemon a terminal runs inside itself says so and is left running.

The plane's word

Signed in, below the minimum or on a blocked version, the app says the refusal as a sentence with Update now, worded from the refusal's fields as the terminal words its own (This plane needs the desktop app 0.15.0-beta or later, and this is 0.14.0-beta: update it now, which installs 0.15.1-beta.), and keeps to the sessions on this computer, as it does when the plane is not answering: the plane is not asked for the team's. Served with action: "suggest", the app says the plane's recommended version in the update's quiet line. A plane from before the policy says nothing either way.

Governs: scripts/release-desktop-update.exs, apps/troupe_protocol/lib/troupe/release/manifest.ex, apps/troupe_protocol/lib/troupe/protocol/client_update.ex, clients/gui/apps/desktop/src-tauri/src/release.rs, clients/gui/apps/desktop/src-tauri/src/update.rs, clients/gui/apps/desktop/src/updates.ts