/clean

name: clean
description: Clean up Kurtosis enclaves and artifacts. Remove stopped enclaves, running enclaves with -a flag, and stopped engine containers. Use when you need to free up resources or start fresh.
compatibility: Requires kurtosis CLI with a running engine.
metadata:
  author: ethpandaops
  version: "1.0"

Clean

Remove Kurtosis enclaves and leftover artifacts.

Basic clean

Removes only **stopped** enclaves and stopped engine containers:

kurtosis clean

Clean everything

Removes **all** enclaves (including running ones):

kurtosis clean -a

Selective removal

To remove a specific enclave without touching others:

# Stop an enclave
kurtosis enclave stop <enclave-name>

# Remove a specific enclave
kurtosis enclave rm <enclave-name>

When clean hangs

On Kubernetes, `kurtosis clean -a` can hang if the logs collector cleanup tries to create pods on tainted/unhealthy nodes. See the `k8s-clean-cluster` skill for manual cleanup steps.

On Docker, if clean hangs:

# Kill the hanging process
pkill -f "kurtosis clean"

# Manually remove containers
docker ps -a | grep kurtosis | awk '{print $1}' | xargs -r docker rm -f

# Remove networks
docker network ls | grep kurtosis | awk '{print $1}' | xargs -r docker network rm

# Restart engine
kurtosis engine start