Skip to content
Mastery HQ Help

Troubleshooting: updates won't install

“You’re up to date” but a newer version exists

Section titled ““You’re up to date” but a newer version exists”

Cause: on versions older than v0.1.75, the updater pointed at a private repository it couldn’t read, so checks failed as “no update”. Fix: install v0.1.75 or newer once by hand (download the installer from the public releases page); from there, auto-update works normally.

The update downloads but never applies

Section titled “The update downloads but never applies”

Cause: the installer needs the app to relaunch, and something blocked it — commonly the app was kept alive in the tray, or antivirus quarantined the installer. Fix:

  1. Fully quit Mastery HQ (tray icon → quit) and reopen — the pending update applies on launch.
  2. If it still doesn’t, check your antivirus quarantine for the downloaded installer and allow it.
  3. Last resort: install the latest MSI/NSIS by hand over the top — settings and workspaces are preserved.

Update check fails on a locked-down network

Section titled “Update check fails on a locked-down network”

Cause: the updater reads a public GitHub releases repo; corporate proxies sometimes block it. Fix: allow github.com / objects.githubusercontent.com, or install manually from another connection.

Does updating wipe my data?

Section titled “Does updating wipe my data?”

No. Workspaces, settings, keys, notes, and attachments live in your user data folder, not the install directory — see data location. Updates replace only the app binaries.