| name | description | compatibility | metadata | ||||
|---|---|---|---|---|---|---|---|
portal |
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. |
Requires kurtosis CLI. |
|
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 startkurtosis portal statuskurtosis portal stopPortal is used with remote Kurtosis contexts. If you're using:
- Local Docker: No portal needed
- Direct Kubernetes: Use
kurtosis gatewayinstead - Remote Kurtosis server: Use portal + remote context
# 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 |