kurtosis-tech/gateway
skills/gateway/SKILL.md
Start and manage the Kurtosis gateway for Kubernetes. The gateway forwards local ports to the Kurtosis engine and services running in a k8s cluster. Required when using Kurtosis with Kubernetes. Use when kurtosis engine status shows nothing on k8s or services aren't reachable.
$ install --global
skillsauthnpx skillsauth add kurtosis-tech/kurtosis gatewayInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 1:20 PM5.5s1 file scanned
SKILL.md
- name:
- gateway
- description:
- Start and manage the Kurtosis gateway for Kubernetes. The gateway forwards local ports to the Kurtosis engine and services running in a k8s cluster. Required when using Kurtosis with Kubernetes. Use when kurtosis engine status shows nothing on k8s or services aren't reachable.
- compatibility:
- Requires kurtosis CLI with Kubernetes cluster access.
- author:
- ethpandaops
- version:
- 1.0
Gateway
The Kurtosis gateway creates local port forwards to the engine and services running in a Kubernetes cluster.
When you need it
The gateway is required when running Kurtosis on Kubernetes. Without it, the local CLI cannot reach the engine pod in the cluster.
Not needed when using Docker backend.
Start the gateway
# Run in the background
kurtosis gateway &
# Or in a separate terminal
kurtosis gateway
Verify it's working
kurtosis engine status
If this returns engine info, the gateway is working. If it says "No Kurtosis engine is running" but you know the engine pod is up, the gateway isn't running.
Stop the gateway
pkill -f "kurtosis gateway"
How it works
The gateway:
- Finds the engine pod in the
kurtosis-engine-*namespace - Creates a local port forward to the engine's gRPC port
- When services are accessed, creates additional port forwards to service pods
- Port mappings shown in
kurtosis enclave inspectpoint to localhost via the gateway
Common issues
| Symptom | Fix |
|---------|-----|
| No engine running but engine pod is up | Start the gateway: kurtosis gateway & |
| Gateway crashes or disconnects | Restart: pkill -f "kurtosis gateway"; kurtosis gateway & |
| Port conflicts | Kill old gateway first: pkill -f "kurtosis gateway" |
| Services unreachable after gateway restart | Re-inspect enclave for new port mappings |
Related Skills
kurtosis-tech/starlark-dev
development
VerifiedTrustedCommunity
Develop and debug Kurtosis Starlark packages. Create packages from scratch, understand the plan-based execution model, use print() debugging, handle future references, and test packages locally. Use when writing or troubleshooting .star files.
534SKILL.mdUpdated Apr 15, 2026
kurtosis-tech/service-manage
data-ai
VerifiedTrustedCommunity
Manage services in Kurtosis enclaves. Add, inspect, stop, start, remove, update services. View logs, shell into containers, and execute commands. Use when you need to interact with running services.
534SKILL.mdUpdated Apr 15, 2026
kurtosis-tech/run-package
content-media
VerifiedTrustedCommunity
Run Starlark scripts and packages with kurtosis run. Covers all flags including dry-run, args-file, parallel execution, image download modes, verbosity levels, and production mode. Use when executing Kurtosis packages locally or from GitHub.
534SKILL.mdUpdated Apr 15, 2026
kurtosis-tech/portal
testing
VerifiedTrustedCommunity
Manage Kurtosis Portal for remote context access. Start, stop, and check status of the Portal daemon that enables communication with remote Kurtosis servers. Use when working with remote Kurtosis contexts.
534SKILL.mdUpdated Apr 15, 2026