Kurtosis cluster-manage

Manage Kurtosis cluster settings. Switch between Docker and Kubernetes backends, list available clusters, and configure which cluster Kurtosis uses. Use when you need to change where Kurtosis runs enclaves.

install

source · Clone the upstream repo

git clone https://github.com/kurtosis-tech/kurtosis

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/kurtosis-tech/kurtosis "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/cluster-manage" ~/.claude/skills/kurtosis-tech-kurtosis-cluster-manage && rm -rf "$T"

manifest: skills/cluster-manage/SKILL.md

Cluster Manage

Switch between Docker and Kubernetes backends for Kurtosis.

Check current cluster

kurtosis cluster get

Returns

docker

kubernetes

List available clusters

kurtosis cluster ls

Switch cluster

# Switch to Docker
kurtosis cluster set docker

# Switch to Kubernetes (uses current kubectl context)
kurtosis cluster set kubernetes

After switching, restart the engine:

kurtosis engine restart

Kubernetes setup

When using Kubernetes:

Ensure

kubectl

is configured and can reach your cluster:

kubectl cluster-info
kubectl get nodes

Switch Kurtosis to Kubernetes:

kurtosis cluster set kubernetes
kurtosis engine start

Start the gateway (required for local CLI to reach the k8s-based engine):
```
kurtosis gateway &
```

Verify:

kurtosis engine status

Config file

The cluster setting is stored in the Kurtosis config file:

kurtosis config path

Typically at

~/Library/Application Support/kurtosis/kurtosis-config.yml

on macOS.