Skip to content

Installation

Linux / macOS

curl -fsSL https://cli.truto.one/install.sh | bash

The installer detects your OS and architecture, downloads the correct binary, and installs it to ~/.truto/bin/truto. Add ~/.truto/bin to your PATH if the installer does not do so automatically.

Install options (Linux / macOS)

# Install a specific version
curl -fsSL https://cli.truto.one/install.sh | TRUTO_VERSION=1.0.36 bash
 
# Install to a custom directory
curl -fsSL https://cli.truto.one/install.sh | TRUTO_INSTALL_DIR=/usr/local/bin bash

Set the variables on bash, not on curl — the installer reads them from its own environment.

Every download is checked against the release's SHA256SUMS manifest, and the installer refuses to continue if the manifest can't be fetched or the digest doesn't match. For an old pinned release that has no manifest, add TRUTO_SKIP_CHECKSUM=1 alongside TRUTO_VERSION to install it unverified.

Windows (PowerShell)

irm https://cli.truto.one/install.ps1 | iex

Installs to %USERPROFILE%\.truto\bin\truto.exe and adds that directory to your user PATH. Open a new terminal after install so the updated PATH is picked up.

Info

Windows on ARM: The installer downloads the x64 binary, which runs under Windows' x64 emulation layer. WSL users can use the Linux install script (install.sh) inside their distro instead.

Install options (Windows)

# Install a specific version
$env:TRUTO_VERSION='1.0.36'; irm https://cli.truto.one/install.ps1 | iex
 
# Install to a custom directory
$env:TRUTO_INSTALL_DIR='C:\Tools\truto'; irm https://cli.truto.one/install.ps1 | iex

Upgrading

# Check if a newer version is available
truto upgrade --check
 
# Upgrade to the latest version
truto upgrade
 
# Re-download even if already on the latest version
truto upgrade --force

The upgrade command fetches the latest release from cli.truto.one, downloads the platform-specific binary, and replaces the currently running binary in place.

Info

On Linux and macOS, if the CLI was installed to a system directory (for example /usr/local/bin), you may need to run sudo truto upgrade. On Windows, run PowerShell as administrator only if you installed to a protected directory.

Tip

Run truto upgrade --check periodically to see if a new version is available without installing it.

Next steps

  1. Create an API token in the dashboard (Settings → API Tokens).
  2. Authenticate with truto login or truto login --token "$TRUTO_API_TOKEN".
  3. Follow the CLI overview quick start to verify with truto whoami and explore your environment.