Software Updates

On Electron builds, Hefty checks for updates automatically on startup. The update check compares the current version against the latest GitHub release to determine whether a newer version is available.

When an update is available, the update dialog displays:

  • Current version vs. latest available version
  • Release notes rendered as Markdown from the GitHub release
  • Platform-specific download links:
    • Linux: .deb package and AppImage
    • macOS: .dmg installer
    • Windows: installer executable
  • "Skip this version" option to dismiss the update prompt

Skipped versions are tracked in localStorage so the same version is not re-offered on subsequent launches.

Upgrade Channel Configuration

Administrators can control which types of updates are allowed. Access this setting via Agent Profile → Upgrade Config (admin only).

Each update type can be independently enabled or disabled:

  • Major updates (e.g., 1.x → 2.x)
  • Minor updates (e.g., 1.2 → 1.3)
  • Patch updates (e.g., 1.2.1 → 1.2.2)

This allows fine-grained control over the update cadence — for example, enabling patches and minors while holding back major version upgrades until manually approved.