Skip to main content

CLI

The speedctl command line tool is used to interact with Speedscale from your own terminal. speedctl is the Speedscale programmable API and the primary way to perform setup actions like installing the Speedscale Operator, generating manifests, etc.

If you are running Speedscale on a local desktop or in Docker Desktop, the CLI is required. For all other users it is highly recommended because it allows programmatic interaction with Speedscale cloud.

Start by installing the Speedscale CLI-based API (speedctl) via Homebrew:

brew install speedscale/tap/speedctl

Or via the install script:

sh -c "$(curl -Lfs https://downloads.speedscale.com/speedctl/install)"
Note

You can inspect the install script to see what it does. Root permission is not required to execute this script.

Install a specific version by passing it to the install script:

sh -c "$(curl -Lfs https://downloads.speedscale.com/speedctl/install)" -s v2.3.86
tip

To install non interactively (like in CI/CD) set the SPEEDSCALE_API_KEY environment variable to your API key

Optionally skip the install script and install manually:

# Download speedctl binary on your machine
curl "https://downloads.speedscale.com/speedctl/speedctl-darwin-$(case $(uname -m) in x86_64) echo 'amd64';; arm | arm64 | aarch64) echo 'arm64';; esac)" -o speedctl

# Create speedscale directory and move the binary to the directory
mkdir ~/.speedscale
mv ./speedctl ~/.speedscale

# Give execute permission to the binary
chmod +x ~/.speedscale/speedctl
Reminder

Don't forget to add speedctl to your $PATH variable in your shell's rcfile:

# substitute your shell's rcfile
echo "export PATH=\$PATH:$HOME/.speedscale" >> ~/.zshrc