cluster manage
- Repo stars 540
- License Apache-2.0
- Author repo kurtosis
- Domain
- DevOps
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 94 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @kurtosis-tech · Apache-2.0
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- macOS · Docker
- Runtime requirements
- Docker
- Detected file/system behavior
-
- Read-only
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# Cluster Manage
Switch between Docker and Kubernetes backends for Kurtosis.
## Check current cluster
```bash
kurtosis cluster get
```
Returns `docker` or `kubernetes`.
## List available clusters
```bash
kurtosis cluster ls
```
## Switch cluster
```bash
# Switch to Docker
kurtosis cluster set docker
# Switch to Kubernetes (uses current kubectl context)
kurtosis cluster set kubernetes
```
After switching, restart the engine:
```bash
kurtosis engine restart
```
## Kubernetes setup
When using Kubernetes:
1. Ensure `kubectl` is configured and can reach your cluster:
```bash
kubectl cluster-info
kubectl get nodes
```
2. Switch Kurtosis to Kubernetes:
```bash
kurtosis cluster set kubernetes
kurtosis engine start
```
3. Start the gateway (required for local CLI to reach the k8s-based engine):
```bash
kurtosis gateway &
```
4. Verify:
```bash
kurtosis engine status
```
## Config file
The cluster setting is stored in the Kurtosis config file:
```bash
kurtosis config path
```
Typically at `~/Library/Application Support/kurtosis/kurtosis-config.yml` on macOS.
Sections and files
Listed in source order.
sections -> Check current cluster → List available clusters → Switch cluster → Kubernetes setup → Config file
terms -> Switch between Docker and Kubernetes backends for Kurtosis. · Returns docker or kubernetes. · Typically at ~/Library/Application Support/kurtosis/kurtosis-config.yml on macOS.
files/cmd -> docker · kubernetes · kubectl · ~/Library/Application Support/kurtosis/kurtosis-config.yml
body sha256 -> cbc35988ce71
Check current cluster
Returns
dockerorkubernetes.Switch cluster
After switching, restart the engine:
Kubernetes setup
When using Kubernetes: Ensure
kubectlis configured and can reach your cluster: Switch Kurtosis to Kubernetes: Start the gateway (required for local CLI to reach the k8s-based engine): Verify:Config file
The cluster setting is stored in the Kurtosis config file: Typically at
~/Library/Application Support/kurtosis/kurtosis-config.ymlon macOS.