Skip to content

Install the Colossus CLI

Install the standalone CLI on a supported system. For the app, see Desktop setup; it includes the CLI.

1. Install the CLI

Choose the method for your system:

curl -fsSL https://github.com/obscuritylabs/Colossus/releases/latest/download/colossus-install.sh | sh

The direct installer verifies the release and its checksum. It installs to a user-local prefix by default and prints the PATH command to use if needed.

On macOS, install from the official tap:

brew install obscuritylabs/tap/colossus

Homebrew owns updates and removal for this installation.

Install from the repository's locked flake:

nix profile install github:obscuritylabs/Colossus

Nix owns updates and removal for this installation.

irm https://github.com/obscuritylabs/Colossus/releases/latest/download/colossus-install.ps1 | iex

Run this in PowerShell. The direct installer verifies the release and its checksum, installs to a user-local prefix by default, and prints the PATH command to use if needed.

Download the archive for your target and its adjacent .sha256 file from Colossus Releases. Copy both files to the target computer. Replace VERSION and TARGET below with the exact names you downloaded.

macOS:

shasum -a 256 -c colossus-VERSION-TARGET.tar.gz.sha256
tar -xzf colossus-VERSION-TARGET.tar.gz
./colossus-VERSION-TARGET/install.sh

Linux:

sha256sum --check colossus-VERSION-TARGET.tar.gz.sha256
tar -xzf colossus-VERSION-TARGET.tar.gz
./colossus-VERSION-TARGET/install.sh

Windows PowerShell:

$archive = "colossus-VERSION-TARGET.zip"
$expected = (Get-Content "$archive.sha256").Split()[0].ToLowerInvariant()
$actual = (Get-FileHash $archive -Algorithm SHA256).Hash.ToLowerInvariant()
if ($actual -ne $expected) { throw "Colossus checksum mismatch" }
Expand-Archive $archive
.\colossus-VERSION-TARGET\install.ps1

For a pinned version, an inspected installer, or a custom prefix, see CLI installation options.

2. Verify the command

Open a new terminal if you changed PATH, then run:

colossus --version

You should see a version number. If the command is not found after a direct install, apply the PATH command printed by the installer and open a new terminal.

What's next?

  • Five-minute quickstart


    Run Colossus offline, find your configuration, and verify the audit journal.

    Start the quickstart

  • Commands and flags


    Explore the commands available in the CLI and terminal UI.

    Browse CLI commands