Skip to content
pier pier

Proxy

$ pier proxy
proxy up — running sessions resolve as <session>.pier (http + https), ports mirror on localhost too; ctrl-c to stop

One proxy serves every running session:

  • Open http://checkout-flow.pier:3000 in a browser, or psql -h checkout-flow.pier.
  • https://checkout-flow.pier:3000 also works, on the same port.
  • Ports the session listens on are discovered and mirrored live.
  • Ports also appear on plain localhost. Auth callbacks and CORS rules that only trust http://localhost:<port> keep working unchanged.

Accelerated dev servers

Section titled “Accelerated dev servers”

The proxy caches modules on your machine and prefetches imports in parallel, so vite-style servers load in seconds over the WAN instead of one round trip per file. The cache warms itself as soon as a port appears, before you open the browser. It persists on disk, so a proxy restart starts warm too.

Proxy and parking

Section titled “Proxy and parking”

A live connection counts as attachment. A session never parks under your open browser tab.

Notes

Section titled “Notes”
  • One sudo on first run.
  • macOS only for now. A Linux proxy is on the roadmap.
  • pier port <session> 3000 is the manual, zero-sudo fallback everywhere. The pair reads local:session, so pier port api 8080:3000 maps local 8080 to the session’s 3000.