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:
Homebrew owns updates and removal for this installation.
Install from the repository's locked flake:
Nix owns updates and removal for this installation.
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:
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.
-
Commands and flags
Explore the commands available in the CLI and terminal UI.