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
TRUTO_VERSION=0.1.0 curl -fsSL https://cli.truto.one/install.sh | bash
 
# Install to a custom directory
TRUTO_INSTALL_DIR=/usr/local/bin curl -fsSL https://cli.truto.one/install.sh | bash

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='0.27.1'; 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.