Skip to main content

Install

Hyveon ships as a packaged Electron desktop app. Download the installer for your OS from the project's GitHub Releases page:

PlatformArtifact
WindowsHyveon Setup *.exe
macOSHyveon-*.dmg
LinuxHyveon-*.AppImage

Why you'll see an "unsigned" warning​

Hyveon's v1 builds are not code-signed — there's no Apple Developer certificate or Windows signing certificate behind them yet (see the code-signing roadmap for the plan to change that). Every OS treats an unsigned binary as unverified and shows a warning before it'll run. That's expected — it doesn't mean the build is broken or tampered with, just that nobody has paid for and configured a signing certificate yet. The steps below get you past each OS's warning.

macOS — System Settings → "Open Anyway"​

macOS Sequoia (15) and later removed the old right-click → Open bypass for unsigned apps — Gatekeeper now requires going through System Settings on first launch:

  1. Double-click the downloaded .dmg and drag Hyveon into Applications.
  2. Double-click Hyveon in Applications. Gatekeeper blocks it with a dialog that has no "Open anyway" option — dismiss it.
  3. Open System Settings → Privacy & Security, scroll down to the Security section, and click "Open Anyway" next to the message about Hyveon. Authenticate as an administrator when prompted.
  4. Launch Hyveon again — it opens normally. This is only required once; subsequent launches (and, on macOS 14 and earlier, right-click → Open) work as normal from here on.

Windows — SmartScreen "More info → Run anyway"​

  1. Run the downloaded Hyveon Setup *.exe.
  2. Windows SmartScreen will show "Windows protected your PC". This is expected for an installer without a Windows signing certificate.
  3. Click "More info", then click the "Run anyway" button that appears.
  4. The NSIS installer runs normally from there.

Linux — make the AppImage executable​

AppImages aren't signed the way .exe/.dmg installers are, but Linux still requires the executable bit to be set before it'll run:

chmod +x Hyveon-*.AppImage
./Hyveon-*.AppImage

What's next​

Once installed, launch Hyveon and follow the first-run wizard to connect your AWS account — see step 6 of the setup guide if you'd rather run from source in dev mode instead.