메뉴
Manage the Kurtosis engine server. Start, stop, restart the engine, check status, and view engine logs. Covers both Docker and Kubernetes engine backends. Use when the engine won't start, needs restarting, or you need to check engine health.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Build and test the Kurtosis CLI from source. Compile the CLI binary locally, run it against Docker or Kubernetes engines, and iterate on CLI changes without creating a release. Use when developing or debugging CLI commands.
Manage Kurtosis contexts for connecting to different Kurtosis instances. Add, list, switch, and remove contexts. Use when working with multiple Kurtosis environments (local, remote, team shared).
Inspect and manage Kurtosis enclaves. List enclaves, view services and ports, examine file artifacts, dump enclave state for debugging, and clean up. Use when you need to understand what's running inside an enclave or export its state.
Inspect, download, upload, and debug Kurtosis file artifacts. View artifacts in an enclave, download them locally for inspection, upload local files, and troubleshoot file mounting issues. Use when services can't find expected files or configs are wrong.
Lint and format Kurtosis Starlark files. Check syntax, validate docstrings, and auto-format .star files. Use when writing or reviewing Starlark packages to ensure code quality.
View and manage port mappings for Kurtosis services. Check which local ports map to service ports and troubleshoot connectivity. Use when services aren't reachable or you need to find the right port.
| name | engine-manage |
| description | Manage the Kurtosis engine server. Start, stop, restart the engine, check status, and view engine logs. Covers both Docker and Kubernetes engine backends. Use when the engine won't start, needs restarting, or you need to check engine health. |
| compatibility | Requires kurtosis CLI. Docker or Kubernetes cluster access depending on backend. |
| metadata | {"author":"ethpandaops","version":"1.0"} |
Manage the Kurtosis engine server lifecycle.
kurtosis engine status
Shows whether the engine is running and its version.
# Start with default settings
kurtosis engine start
# Start with debug images
kurtosis --debug-mode engine start
On Kubernetes, the engine runs as a pod in a kurtosis-engine-* namespace. You also need to run kurtosis gateway to access it from your local machine.
kurtosis engine stop
kurtosis engine restart
Equivalent to stop + start. Useful after changing cluster settings or upgrading.
kurtosis engine logs
Dumps engine server logs. Useful for diagnosing startup failures or API errors.
# Check which backend is active
kurtosis cluster get
# Switch to Docker
kurtosis cluster set docker
kurtosis engine restart
# Switch to Kubernetes
kurtosis cluster set kubernetes
kurtosis engine restart
kurtosis gateway # Required for k8s
When running on Kubernetes:
# The engine runs in its own namespace
kubectl get ns | grep kurtosis-engine
# Check engine pod
kubectl get pods -n <engine-namespace>
# View engine logs directly
kubectl logs <engine-pod> -n <engine-namespace>
# Start the gateway (required for local CLI to reach k8s engine)
kurtosis gateway &
| Symptom | Fix |
|---|---|
No Kurtosis engine is running | Run kurtosis engine start |
Engine starts but engine status shows nothing (k8s) | Start the gateway: kurtosis gateway |
| Version mismatch warning | kurtosis engine restart to match CLI version |
| Engine start hangs (k8s) | Check pods: kubectl get pods -A | grep kurtosis |
| Old engine blocking new start | kurtosis engine stop then clean namespaces |