More · System · Auto-update

Auto-update

When a new version is out, a titlebar accent pill announces it. Click it to install via download → restart. It checks once automatically when you launch the app, and you can also check directly from the About window.

New-version notification (titlebar pill)

When a new version is detected, an accent pill appears on the right of the titlebar. Click it to proceed to install; press close to hide just that notification.

orchterm — titlebar · update pillrelease

OOrch term

1 ssh-core

2 docs

① Download icon + update version label + close — in the slot left of the window controls.

The pill label changes with progress.

New version — click to start installing.
Downloading — shows progress.
Ready to install — restart to switch to the new version.
Failed — click to try again.

Download · restart install

Clicking the pill opens a confirmation dialog before installing. If you agree, it downloads and installs the new version and restarts the app. Cancel and nothing is downloaded — you return to the notification state.

Install update — confirm

① Install confirmation dialog. Cancel touches no network.

Installing restarts the app. Save any work in progress first.

For the rare update that changes the internal service that manages terminals, the confirm dialog also shows how many terminals are currently running — only that kind of update closes your open terminals on install (ordinary updates keep them running). AI agent conversations reopen after the restart.

Boot check · manual About check

Update checks come in two paths — once automatically when the app launches, and directly via the Check for Updates button in the About window. The two share their result, so a new version found in About also appears in the titlebar pill.

About — manual update check

① Pressing Check for Updates shows a result message — up to date / new version available / check failed.

Beta updates

The "Check for beta" button in the About window checks for a pre-release (beta) build, and if a newer beta exists you install it from the top banner. Betas are only checked when you press this button and are never offered by the normal automatic update. When the next stable release comes out, beta users are updated to it normally.

Signing · release notes

Updates are verified by signature, so a tampered build won't install. Release notes (the changes) are generated automatically from commits and shown in both the GitHub release and the in-app notification — they're not written by hand.

DEV unsupported · platform constraints

Auto-update is for release builds only. Development (dev) builds have no automatic boot check, and pressing Check for Updates only shows an unsupported notice.

About — dev build

① In dev builds, even the manual button only shows an unsupported notice (no network calls).

Installers ship as a single Windows setup program (orchterm-setup.exe) and a macOS .dmg. No .msi is published.