Skip to content

Install ​

How to get Sevorix Pro onto a Linux or macOS machine, by script or by hand. The installer prompts before every privileged step — Installer Prompts explains each one.

Before you start ​

  • Linux x86_64 (including WSL2), or macOS on Apple Silicon. Sevorix Pro is distributed as prebuilt binaries for these two platforms. On macOS, only Apple Silicon (M-series) Macs are supported — Intel Macs are not. On Windows, set up WSL2 first with Microsoft's WSL install guide.
  • An active Sevorix Pro subscription. sevorix start checks your subscription with Sevorix Hub and refuses to start without one — there is no offline or degraded mode. See sevorix.com for pricing.
  • sudo rights, for the privileged steps. Every one of them is optional and prompted for individually — you can decline all of them and still get a working install, with the reduced coverage noted in Installer Prompts. On macOS, the installer puts everything in ~/.local/bin and asks for sudo only to trust the TLS inspection certificate, if you have enabled TLS inspection.

Sevorix Lite: open source, no account needed

Sevorix Lite is a separate, open-source edition (AGPL-3.0) with the same enforcement core and a smaller feature set. It builds from source — including on Intel Macs, which Pro does not support — and needs no subscription. Lite is a distinct product, not a source release of Pro; its README covers installing it. See Editions for what each includes.

Quick install ​

These steps are for Linux. On a Mac, see macOS (Apple Silicon).

bash
curl -fsSL https://raw.githubusercontent.com/sevorix/sevorix/main/install.sh | bash

The script downloads the latest release from sevorix/sevorix, verifies its SHA-256, and runs the bundle's own installer — which prompts before every privileged step, even when the script itself arrived through a pipe. Installer Prompts explains what each prompt does and what declining costs.

For an unattended install (CI, cloud-init, image builds), accept every prompt up front with --yes:

bash
curl -fsSL https://raw.githubusercontent.com/sevorix/sevorix/main/install.sh | bash -s -- --yes

--yes accepts the privileged steps too, including the system-wide kernel setting — read through Installer Prompts before using it on a machine you care about. Other flags: --version X.Y.Z pins a release, --dry-run shows what would happen, --help lists the rest.

Piping a script to a shell means running code you have not read. If you would rather not, read install.sh first, or follow the manual install below — it is the same install in four steps.

Then log in and start.

Manual install ​

These steps are for Linux. On a Mac, see macOS (Apple Silicon).

1. Download the release archive and its checksum:

bash
VERSION=$(curl -s https://api.github.com/repos/sevorix/sevorix/releases/latest | grep tag_name | cut -d'"' -f4)
curl -LO https://github.com/sevorix/sevorix/releases/download/${VERSION}/sevorix-pro-${VERSION}-x86_64-linux.tar.gz
curl -LO https://github.com/sevorix/sevorix/releases/download/${VERSION}/sevorix-pro-${VERSION}-x86_64-linux.tar.gz.sha256

2. Verify the download. This is not optional: the installer asks for sudo and installs a root-owned binary that every shell command your agent runs will be routed through.

bash
sha256sum -c sevorix-pro-${VERSION}-x86_64-linux.tar.gz.sha256

The expected checksum is also printed in the release notes, so you can compare against a second source rather than a file downloaded from the same place as the archive.

3. Extract and run the installer:

bash
tar xzf sevorix-pro-${VERSION}-x86_64-linux.tar.gz
cd sevorix-pro-${VERSION}-x86_64-linux
./install-binary.sh

Pass --force to accept every prompt without asking. As with --yes above, that includes the system-wide kernel setting. Each prompt is explained in Installer Prompts.

4. Log in and start.

macOS (Apple Silicon) ​

The macOS build is a native Apple Silicon binary, and a subset of the Linux one: much of Sevorix's Linux enforcement is built on kernel features macOS does not have. Read What's different on macOS before you rely on it.

Quick install ​

bash
curl -fsSL https://raw.githubusercontent.com/sevorix/sevorix/main/install-macos.sh | bash

The script downloads the latest macOS release from sevorix/sevorix, verifies its SHA-256, and runs the bundle's own installer, which prompts before every privileged step. For an unattended install, accept those steps up front with --yes:

bash
curl -fsSL https://raw.githubusercontent.com/sevorix/sevorix/main/install-macos.sh | bash -s -- --yes

Other flags: --version X.Y.Z pins a release, --dry-run shows what would happen, --help lists the rest.

As on Linux, piping a script to a shell means running code you have not read. If you would rather not, read install-macos.sh first, or follow the manual install below.

Then activate a role and log in and start.

Manual install ​

1. Download the release archive and its checksum:

bash
VERSION=$(curl -s https://api.github.com/repos/sevorix/sevorix/releases/latest | grep tag_name | cut -d'"' -f4)
curl -LO https://github.com/sevorix/sevorix/releases/download/${VERSION}/sevorix-pro-${VERSION}-aarch64-macos.tar.gz
curl -LO https://github.com/sevorix/sevorix/releases/download/${VERSION}/sevorix-pro-${VERSION}-aarch64-macos.tar.gz.sha256

Download with curl, not a browser

The macOS binaries are not notarized by Apple. Downloads made with curl are unaffected, but if you download the archive in a browser, macOS will refuse to run the binaries until you clear the quarantine flag on the extracted bundle:

bash
xattr -dr com.apple.quarantine sevorix-pro-${VERSION}-aarch64-macos

2. Verify the download:

bash
shasum -a 256 -c sevorix-pro-${VERSION}-aarch64-macos.tar.gz.sha256

The expected checksum is also printed in the release notes, so you can compare against a second source rather than a file downloaded from the same place as the archive.

3. Extract and run the installer:

bash
tar xzf sevorix-pro-${VERSION}-aarch64-macos.tar.gz
cd sevorix-pro-${VERSION}-aarch64-macos
./install-binary-macos.sh

This is a different installer from Linux's install-binary.sh; Installer Prompts describes the Linux one.

4. Activate a role, then log in and start.

Activate a role ​

Every sevsh command is evaluated against a role. In 1.0.2, the macOS installer does not activate one for you, so sevsh refuses every command with "No role configured for this session" until you set one in ~/.sevorix/settings.json:

json
{
  "sevsh": { "default_role": "default" }
}

If the file already exists, add the "sevsh" key to it rather than replacing the file. If the daemon is already running, restart it (sevorix stop && sevorix start): default_role is read only at startup.

What's different on macOS ​

Available on macOS: the HTTP proxy, including TLS inspection; the policy engine and roles; sevsh; the Observatory; and the Pro features.

Linux only — not available on macOS:

  • eBPF syscall monitoring and seccomp syscall interception. Nothing is enforced at the kernel level: a command that does not go through sevsh, and traffic that does not go through the proxy, is not seen.
  • Agent integrations (sevorix integrations start). On macOS, point the agent at sevsh yourself.
  • Session containment. A flagged command is still held until you decide, but the agent's other processes keep running in the meantime instead of being frozen.
  • The uninstaller (uninstall.sh).

Runtime containment for autonomous AI agents.