Skip to main content
Early access: get Pro free for 3 months →
DocsContact
Getting Started

Installation

HZSec ships as a signed desktop application for macOS and Windows. Thehzsec CLI is bundled with the app and added to your PATH during installation.

macOS

Requires macOS 12.0 (Monterey) or later. Apple Silicon native — no Rosetta required.

Install

  1. Download HZSec.dmg from hzsec.io/download.
  2. Open the .dmg and drag HZSec.app to /Applications.
  3. Double-click HZSec to launch. macOS Gatekeeper validates the Apple notarization automatically on first open.
  4. HZSec adds hzsec to your PATH on first launch — open a new terminal tab to use it.

Verify the signature

# Check notarization and Developer ID signature
spctl --assess --verbose /Applications/HZSec.app

# Expected:
# /Applications/HZSec.app: accepted
# source=Notarized Developer ID

Windows

Requires Windows 10 version 1903 or later, or Windows 11. Both x64 and ARM64 are supported.

Install

  1. Download HZSec-Setup.exe from hzsec.io/download.
  2. Right-click the installer and choose Run as administrator, or accept the UAC prompt when it appears.
  3. Follow the setup wizard. HZSec installs to %ProgramFiles%\HZSec by default.
  4. Open a new terminal — hzsec is added to your system PATH by the installer.

Verify the Authenticode signature

# In PowerShell
Get-AuthenticodeSignature .\HZSec-Setup.exe | Select-Object Status, SignerCertificate

# Expected:
# Status : Valid
# SignerCertificate : [HZSec, Inc.]

Linux

A Linux build is in development. To be notified when it ships, email hello@hzsec.io with Linux build in the subject line.

Check your version

hzsec --version
# HZSec v1.1.0 (darwin/arm64)

Updating HZSec

HZSec checks for updates on launch and shows a banner when one is available. To update, download the latest installer from hzsec.io/download and run it — the installer replaces the existing installation in place.

CVE rule data is refreshed from CISA KEV and NVD in the background and does not require a full app update.

Uninstalling

macOS: Drag HZSec.app to the Trash. HZSec stores all local data (scan history, settings, encrypted API key) in ~/.shieldops. To remove it completely:
rm -rf ~/.shieldops
Windows: Go to Settings → Apps → HZSec → Uninstall. Local data is stored in %USERPROFILE%\.shieldops and is not removed automatically — delete that folder if you want a clean removal.
← QuickstartFirst Scan →