OpenParable
Skip to content
← Back to skills

Portal

Apps & Automation
portal

Portal is an Agent Skill for apps & automation published in the kurtosis-tech/kurtosis repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/kurtosis-tech/kurtosis/blob/HEAD/skills/portal/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/portal, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Portal

Manage the Kurtosis Portal daemon for remote context access.

What is Portal?

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.

Start

kurtosis portal start

Check status

kurtosis portal status

Stop

kurtosis portal stop

When you need it

Portal is used with remote Kurtosis contexts. If you're using:

  • Local Docker: No portal needed
  • Direct Kubernetes: Use kurtosis gateway instead
  • Remote Kurtosis server: Use portal + remote context

Remote contexts

# 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

Troubleshooting

SymptomCauseFix
Portal won't startPort conflict or stale processRun kurtosis portal stop then kurtosis portal start
Status shows not runningPortal crashed or was killedRestart with kurtosis portal start
Services unreachable via portalPortal not started for current contextRun kurtosis portal status to check, then kurtosis portal start
Connection refused errorsWrong context or portal not neededVerify context with kurtosis context ls — local Docker doesn't need portal