---
title: Installation
---
# Installation
## Install
### Linux / macOS

```bash
$ curl --proto '=https' --tlsv1.2 -fsSL https://sh.sysg.dev/ | sh
```
### Homebrew
```bash
$ 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
```bash
$ sysg --version
```
## Specific version
Install a specific version:
```bash
$ 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:
```bash
$ 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`](/docs/installation/upgrading) for compatibility and
[`SG0502`](/reference/dialog/codes#sg0502) recovery.
## Next steps
Create your first [configuration](/docs/quickstart#create-a-configuration) and start running services.