Skip to content

Auto Update

Thiago Miranda edited this page Jun 18, 2026 · 1 revision

Auto-Update

Getman can check for new versions on its own and walk you through installing them. Desktop only (macOS, Windows, Linux) — the web build has nothing to update, so these controls are hidden there.

The startup check

When CHECK FOR UPDATES ON STARTUP is on (the default), Getman makes a single check against its GitHub Releases page each time it launches. If a newer version is available, an UPDATE AVAILABLE dialog appears. If you're already up to date, nothing happens — the check is silent.

Turning the toggle off stops the automatic check entirely (no network call on launch); you can still check by hand anytime with the button below.

The update prompt

When a newer version is found, the dialog shows the new version number, the release notes, and a reminder about the unsigned-app step (below). It offers three choices:

  • UPDATE NOW — download the installer for your platform and open it (see Installing the update).
  • SKIP THIS VERSION — don't prompt about this version again. You'll still be told when an even newer version ships later.
  • LATER — dismiss for now; you'll be asked again next launch.

Checking manually

Open SETTINGS → GENERAL (see Settings). Under UPDATES you'll find:

  • CHECK FOR UPDATES ON STARTUP — the toggle described above.
  • CHECK FOR UPDATES — a button that checks right now. A manual check always reports its result: it shows the update dialog if one's available (even a version you previously skipped), or a "You're on the latest version." message if not. If the check can't reach GitHub you'll see "Couldn't check for updates."

The current version is shown next to the button (e.g. Getman 1.0.0).

Installing the update

Choosing UPDATE NOW downloads the right artifact for your OS and opens it. What happens next depends on the platform:

  • macOS — a .dmg mounts; drag Getman onto the Applications folder to replace your installed copy.
  • Windows — a setup.exe installer runs; follow the prompts. It updates your existing install and can relaunch Getman.
  • Linux — the new AppImage is downloaded and revealed in your file manager; run it (it's a portable app — use it in place of your old AppImage).

The download lands in your Downloads folder.

Unsigned-app warning (important)

Getman is not code-signed, so the first time you open an updated build your OS will warn you. This is expected — the update still works, you just have to allow it:

  • macOS (Gatekeeper) — if you see "Getman can't be opened because Apple cannot check it for malicious software," right-click (or Control-click) the app → Open, then confirm. You only need to do this once per version.
  • Windows (SmartScreen) — if you see "Windows protected your PC," click More info → Run anyway.

Notes

  • The check reads only the public GitHub Releases list — no account or sign-in is needed.
  • It uses its own connection, independent of your Settings#network settings, so your request configuration can't interfere with updates.
  • If GitHub is unreachable or rate-limited, the check quietly does nothing — your work is never interrupted.

Clone this wiki locally