// 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.
| name | portal |
| description | 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. |
| compatibility | Requires kurtosis CLI. |
| metadata | {"author":"ethpandaops","version":"1.0"} |
Manage the Kurtosis Portal daemon for remote context access.
Kurtosis Portal is a lightweight local daemon that enables communication with Kurtosis enclaves running on a remote Kurtosis server. It's only needed when using remote contexts — not required for local Docker or direct Kubernetes access.
kurtosis portal start
kurtosis portal status
kurtosis portal stop
Portal is used with remote Kurtosis contexts. If you're using:
kurtosis gateway instead# List contexts
kurtosis context ls
# Add a remote context
kurtosis context add <context-name>
# Switch to remote context
kurtosis context set <context-name>
# Start portal for the remote context
kurtosis portal start
| Symptom | Cause | Fix |
|---|---|---|
| Portal won't start | Port conflict or stale process | Run kurtosis portal stop then kurtosis portal start |
| Status shows not running | Portal crashed or was killed | Restart with kurtosis portal start |
| Services unreachable via portal | Portal not started for current context | Run kurtosis portal status to check, then kurtosis portal start |
| Connection refused errors | Wrong context or portal not needed | Verify context with kurtosis context ls — local Docker doesn't need portal |
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.