Installing raff

_{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.

Getting Started

Guides

REST API

CLI

Terraform

Installing raff

View on GitHub

Downloading a Release from GitHub

Quickest — auto-detect the latest version

Pinning to a specific version

Building the Development Version from Source

Next steps

Configure

VM commands

View on GitHub

​Downloading a Release from GitHub

​Quickest — auto-detect the latest version

​Pinning to a specific version

​Building the Development Version from Source

​Next steps

Configure

VM commands

Downloading a Release from GitHub

Quickest — auto-detect the latest version

Pinning to a specific version

Building the Development Version from Source

Next steps