Skip to main content
Version: 0.83.2

Installing Kurtosis

The instructions in this guide will walk you through installing the latest version of Kurtosis.


We're working on a cloud-hosted version of Kurtosis that doesn't require installing anything. If this interests you, let us know here and we'll let you know when it's ready!

If you already have Kurtosis installed and you're looking to upgrade to latest, see here.

If you're looking to install a historical version instead, see here.

I. Install & Start Docker

  1. If you don't already have Docker installed, follow the instructions here to install the Docker application specific to your machine (e.g. Apple Intel, Apple M1, etc.).
  2. Start the Docker daemon (e.g. open Docker Desktop)
  3. Verify that Docker is running:
    docker image ls

II. Install the CLI

brew install kurtosis-tech/tap/kurtosis-cli

Homebrew might warn you that your Xcode is outdated or missing entirely. This is a Homebrew requirement, and has nothing to do with Kurtosis (which ships as prebuilt binaries).

To install or update your Xcode, run:

xcode-select --install

III. (Optional) Add command-line completion

Kurtosis supports command-line completion to allow completing subcommands and dynamic values (e.g. enclave name during enclave inspect). This isn't required, but we believe it significantly enhances the Kurtosis experience for those who are using . If you'd like to install it, see these instructions.

Run the quickstart

If you're new to Kurtosis, you might like the quickstart as a good onboarding to get started with Kurtosis.