systemg 0.66.6

An agent-friendly general-purpose program orchestrator for busy people.
Documentation
---
title: Installation
---

# Installation

## Install

### Linux / macOS

![Installation](https://i.imgur.com/JHQPtJp.gif)

```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.