systemg 0.61.2

An agent-friendly general process composer.
Documentation
---
title: Installation
---

# Installation

## Install

### Linux / macOS

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

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

## 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`](/installation/upgrading) for compatibility and
[`SG0502`](/how-it-works/dialog/codes#sg0502) recovery.

## Next steps

Create your first [configuration](quickstart#create-a-configuration) and start running services.