pikopod up - pikopod

pikopod up [flags]

Starts two listeners: the agent on listen:agent_port (default 127.0.0.1:4700) and the sandbox on listen:sandbox_port (default 127.0.0.1:4600). Both share data_dir and fail independently. The spec watcher runs inside up for every upstream with a spec_source. Runs until SIGINT or SIGTERM, then drains for three seconds.

Flag	Meaning
`--wallclock-faults`	Every armed fault delays or hangs on the real wire. By default delays are virtualized and instant, which is what `scenario check` measures against.
`--spec <file-or-url>`	Serve one sandbox from this spec with no config file, in a temporary data directory removed on exit. No agent.
`--name <n>`	With `--spec`: the sandbox name. Default: the spec’s file name.
`--seed <s>`	With `--spec`: the sandbox seed. Default: random.
`--seed-data <file>`	With `--spec`: resources to store before the first request. See Running.
`--port <n>`	With `--spec`: the sandbox port. Default `4600`.

Zero config

pikopod up --spec ./examplepay.spec.json

sandbox examplepay registered (sbx_6932b80316f5d1d5, 4 endpoints)
responses: 0 field(s) synthesised without spec, example or convention
serve it with `pikopod up` → http://127.0.0.1:4600/examplepay/...
test credential (send it the way the spec's auth scheme expects, e.g. the Authorization header):
  pikopod_sbx_test_cd407f549348ce704a784a71a99566ddb44dc1394cde3354
pikopod sandbox on http://127.0.0.1:4600  (sandboxes: examplepay) — temporary data dir, removed on exit
no agent: --spec serves the sandbox only; add an upstream to pikopod.yaml to proxy and record real traffic

Output

spec-declared enums: 1 field(s) across 1 upstream(s) keep their declared values readable on disk
spec watch ON: 1 declared source(s), re-checked every 1h0m0s
pikopod agent on http://127.0.0.1:4700  (upstreams: examplepay)
point your app's provider base URL at http://127.0.0.1:4700/<upstream>; /healthz shows progress
pikopod sandbox on http://127.0.0.1:4600  (sandboxes: examplepay)

Before serving, up lints every volatile_fields entry against what has been learned and prints any dead, stable or over-broad entry. See Volatile fields.

Refuses to start when

upstreams is empty.
listen is not loopback and no token is configured.
A sandbox has a webhook sink and its spec declares a signature, but the environment variable the envelope names is unset.
A volatile_fields entry is malformed.
The salt, the token file, or a config file holding a model key is readable by other users.

Every refusal names the fix. See Troubleshooting.

Observe, Running the sandbox, Deployment, Configuration.