Skip to main content

​
Install Cerulion CLI

Cerulion CLI is distributed as a single static binary. No runtime dependencies are required beyond an up-to-date OpenSSL.

​
macOS

1

Download the latest binary

curl -L "https://downloads.cerulion.com/cli/latest/macos-universal.tar.gz" -o cerulion-cli.tar.gz
tar -xzf cerulion-cli.tar.gz
2

Move into your PATH

sudo mv cerulion /usr/local/bin/
cerulion --version
3

Enable completions (optional)

cerulion completion zsh | sudo tee /usr/local/share/zsh/site-functions/_cerulion >/dev/null
exec zsh

​
Linux

1

Download the latest binary

curl -L "https://downloads.cerulion.com/cli/latest/linux-x86_64.tar.gz" -o cerulion-cli.tar.gz
tar -xzf cerulion-cli.tar.gz
2

Move into your PATH

sudo mv cerulion /usr/local/bin/
cerulion --version
3

Install completions (bash)

cerulion completion bash | sudo tee /etc/bash_completion.d/cerulion >/dev/null
source /etc/bash_completion

​
Windows via WSL2

  1. Install WSL2 with an Ubuntu or Debian image.
  2. Follow the Linux steps inside WSL2.
  3. Add cerulion to your shell profile if /usr/local/bin is not in $PATH.
Native Windows (without WSL2) is not supported for zero-copy transports. Use WSL2 or containerized environments.

​
Upgrading

Use the built-in upgrade command to fetch the latest signed release: 
cerulion upgrade
The CLI verifies signatures before replacing the binary. If verification fails, the upgrade aborts without altering your current version.

​
Verifying the binary

cerulion version --output json
cerulion verify --path /usr/local/bin/cerulion
Expected output includes the semantic version, build channel, and a verified: true flag. Use cerulion verify in CI to ensure supply-chain integrity.

​
Prerequisites

  • OpenSSL 1.1+ available on the host
  • Network access to downloads.cerulion.com (for upgrades)
  • For telemetry and auth flows: outbound HTTPS allowed to api.cerulion.com
All commands work offline after the initial login. The CLI queues telemetry locally and ships it once connectivity returns.