Installation
Install the CLI from an approved release and verify the package before use.
Requirements#
The reference CLI supports Linux, macOS, and Windows on x86-64 or ARM64. It requires an HTTPS connection to your organization’s control-plane endpoint. No background agent is needed for CLI access.
| Component | Requirement |
|---|---|
| CLI | Version 2.4 or later |
| Runtime | No separate runtime required |
| Network | HTTPS access to your organization endpoint |
| Credentials | A workspace-scoped token or interactive SSO session |
Verify a release package#
Obtain the CLI archive and its checksum file from your organization’s approved release channel. Compare the checksum before adding the binary to your path.
sha256sum -c du-cli.sha256
tar -xzf du-cli-linux-amd64.tar.gz
install -m 0755 du "$HOME/.local/bin/du"
du versionConnect to your control plane#
du config set endpoint https://control.universe.example
du auth login
du doctordu doctor checks connectivity, server compatibility, and local configuration. It does not print stored credentials.