Skip to main content
Updated May 10, 2026 The Raff CLI is a single static binary written in Go. Most users grab a pre-built release from GitHub; if you have a Go toolchain you can build from source.

View on GitHub

github.com/RaffTechnologies/raff-cli — source, releases, issues, and the changelog.

​
Downloading a Release from GitHub

Visit the Releases page for archives matching your OS / architecture. Builds are published for linux, macos, windows × amd64, arm64.

​
Quickest — auto-detect the latest version

# Linux x86_64
curl -sL "https://api.github.com/repos/RaffTechnologies/raff-cli/releases/latest" \
  | grep "browser_download_url.*linux_x86_64.tar.gz" \
  | cut -d'"' -f4 | xargs curl -sL | tar -xzv
sudo mv raff /usr/local/bin/
Replace linux_x86_64 with linux_arm64, macos_x86_64, or macos_arm64 as needed.

​
Pinning to a specific version

Replace 0.3.4 below with the version you want from the Releases page. 
# Linux x86_64
curl -sL https://github.com/RaffTechnologies/raff-cli/releases/download/v0.3.4/raff_0.3.4_linux_x86_64.tar.gz | tar -xzv
sudo mv raff /usr/local/bin/

# macOS arm64 (Apple Silicon)
curl -sL https://github.com/RaffTechnologies/raff-cli/releases/download/v0.3.4/raff_0.3.4_macos_arm64.tar.gz | tar -xzv
sudo mv raff /usr/local/bin/
For Windows, download the matching .zip from the Releases page in your browser, extract raff.exe, then follow How to: Add Tool Locations to the PATH Environment Variable to put it on your PATH. Verify the install: 
raff --version

​
Building the Development Version from Source

If you have a Go environment configured, you can install the development version of raff from the command line: 
go install github.com/RaffTechnologies/raff-cli/cmd/raff@latest
This installs the CLI (the raff binary) — not the raff-go SDK library. The path ends in cmd/raff because that’s the CLI’s main package inside the raff-cli repo. The binary lands in $(go env GOPATH)/bin/raff — make sure that directory is in your PATH. While the development version is a good way to take a peek at the latest features before they’re released, be aware that it may have bugs. Officially released versions will generally be more stable. Or build from a clone: 
git clone https://github.com/RaffTechnologies/raff-cli.git
cd raff-cli
make build       # produces ./bin/raff
make install     # installs into $GOBIN
Requires Go 1.25+.

​
Next steps

Configure

Authenticate and set up profiles.

VM commands

Start using the CLI to manage Virtual Machines.
Last modified on May 11, 2026