Installation

Install

Linux / macOS

$ curl --proto '=https' --tlsv1.2 -fsSL https://sh.sysg.dev/ | sh

Homebrew

$ brew install ra0x3/tap/sysg

Homebrew owns the binary it installs, so brew upgrade sysg swaps it without the live re-execution the installer performs. A supervisor that is already resident keeps serving the build it booted from until it is stopped; sysg version reports both.

Verify

$ sysg --version

Specific version

Install a specific version:

$ curl --proto '=https' --tlsv1.2 -fsSL https://sh.sysg.dev/ | sh -s -- --version 0.56.1

Switch versions

Switch to an already installed version, or download it:

$ curl --proto '=https' --tlsv1.2 -fsSL https://sh.sysg.dev/ | sh -s -- -v 0.56.1

The installer validates the downloaded binary before changing the active version. A newer release can upgrade a running supervisor without restarting its services when both binaries advertise the same live-reexec protocol and handoff schema; major and minor version boundaries do not decide compatibility. Residents from 0.56.0 through 0.57.0 still enforce the original same-major/minor rule; earlier residents do not support live re-execution. See Upgrading sysg for compatibility and SG0502 recovery.

Next steps

Create your first configuration and start running services.