Project maintained by kurtosis-tech Hosted on GitHub Pages — Theme by mattgraham

Installing & Upgrading

Interacting with Kurtosis is done via a CLI; the instructions below will walk you through installing it.

TIP: The CLI supports tab completion. After you install using one of the methods below, follow these instructions to enable tab completion.



brew install kurtosis-tech/tap/kurtosis-cli

NOTE: Homebrew might warn you that your Xcode is outdated, like so:

Error: Your Xcode (11.5) is too outdated.
Please update to Xcode 12.5 (or delete it).

This is a Homebrew requirement, and has nothing to do with Kurtosis (which ships as prebuilt binaries). To update your Xcode, run:

xcode-select --install


echo "deb [trusted=yes] https://apt.fury.io/kurtosis-tech/ /" | sudo tee /etc/apt/sources.list.d/kurtosis.list
sudo apt update
sudo apt install kurtosis-cli


echo '[kurtosis]
gpgcheck=0' | sudo tee /etc/yum.repos.d/kurtosis.repo
sudo yum install kurtosis-cli

deb, rpm, and apk

Download the appropriate artifact from the release artifacts page.

Once the CLI is installed, the quickstart is a great place to get started.

Metrics Election

The first time you run the Kurtosis CLI, you’ll be asked to make an election about whether you’d like to send anonymized product analytics metrics. Our reasons for doing this, and how we strive to do this ethically, can be found here.

If you’re running the CLI in a CI environment, see these instructions to see how to make the metrics election non-interactively.


You can check the version of the CLI you’re running with kurtosis version. To upgrade to latest, check the changelog to see if there are any breaking changes and follow the steps below.

NOTE: if you’re upgrading the CLI’s minor version (the Y in a X.Y.Z version), you may need to restart your Kurtosis engine after the upgrade. If this is needed, the Kurtosis CLI will prompt you with an error like so:

The engine server API version that the CLI expects, 1.7.4, doesn't match the running engine server API version, 1.6.8; this would cause broken functionality so you'll need to restart the engine to get the correct version by running 'kurtosis engine restart'

The fix is to restart the engine like so:

kurtosis engine restart


brew upgrade kurtosis-tech/tap/kurtosis-cli


apt install --only-upgrade kurtosis-cli


yum upgrade kurtosis-cli

deb, rpm, and apk

Download the appropriate artifact from the release artifacts page.

Back to index