PortalSAFE

A platform for packaging and launching blockchain infra. Think docker compose for blockchain

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
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"
---

# 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

```bash
kurtosis portal start
```

## Check status

```bash
kurtosis portal status
```

## Stop

```bash
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

```bash
# 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

| 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 |

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.