Ports
A server on the box opens on your machine as localhost within about two seconds, with no flags or config, and any port can be shared with your workspace at a prized.dev link.
How it works
A TCP port opens at the same number on your machine's 127.0.0.1, websockets included; servers bound only to the box's loopback (Vite, most dev servers) work too. On Windows this works while you are signed in.
npm run dev
# ready on http://localhost:3000
# two seconds later, localhost:3000 works on your machineInspect and toggle
| Command | What it does |
|---|---|
prized ports ls | Every box listener, its process, and its mirror state. |
prized ports toggle 3000 | Flip a port off or back on; the choice survives restarts. |
prized proxy box-3fa9 5432 | Forward one port from any box to 127.0.0.1:5432 until Ctrl-C. |
An interactive prized ssh or prized mosh session to a non-default box forwards that box's ports while it lasts.
Limits
| Limit | What it means |
|---|---|
| TCP only | UDP is not forwarded. |
| Ports 3000 through 9999 | Auto-mirrored; the range and per-port allow and never lists are in the config's [ports] section. |
| Never mirrored | Ports below 1024, port 22, and the agent's port 7377; 5900 is off by default. Other ports outside the range need an allow-list entry or prized proxy. |
| Open to your whole machine | Like ssh -L or docker -p 127.0.0.1:: on a machine shared with other accounts, treat a mirrored port as unprotected. |
| Local wins | If something on your machine already uses the port, the mirror waits, prized proxy refuses it, and an ssh session skips it. |
| Every request crosses the network | Run an app that makes many database round trips per page on the box, beside its database, and mirror only the app port. |
Share a port with your team
prized ports share 3000 gives the port a prized.dev link that members of your workspace open in a browser, with nothing to install.
prized ports share 3000
# ✓ port 3000 on mango shared
# https://mango-3000-k7x2q9.p.prized.dev/| Topic | What happens |
|---|---|
| Who can open it | Members of your workspace who can see the box, after signing in to Prized; anyone else sees a page saying the link is not available to their account. There is no public link, and no way to make one. |
| What it carries | HTTP and websockets, so hot reload works. The app sees itself reached as localhost:3000, so host and origin checks pass. Anything else (a database, SSH) needs prized proxy. |
| A paused box | Wakes when the link is opened; the page retries until the box answers. |
| Stop sharing | prized ports unshare 3000, or Stop sharing on the box page, ends the link for everyone within a moment; so does deleting the box or closing the workspace. Removing a member, or making them a contractor, ends their access, open pages included. |
| Cookies | Each link has its own host under p.prized.dev. A cookie your app sets with a wider Domain is stored for that link alone, so it never reaches a teammate's shared port; nothing else about the cookie changes. |
| "Too many requests" | A browser or script is asking faster than a shared port serves; reload in a moment. |
| The log | Sharing, stopping, and each member's first opening are rows on the audit log. |
The same controls are on the box page under Settings, Access, Shared ports (Dashboard); prized ports share with no port lists what the box shares. Links pass through the browser terminal's relay, which can see the traffic as it passes and stores nothing (Security).
A second box
A box connected with prized setup --box mango mirrors its own ports; aim commands at it with prized --box mango ports ls and prized --box mango ports toggle 3000 (Several boxes).
The same port on two boxes collides on your machine: the second mirror shows as conflicted in ports ls; toggle it off on one box, or add it to [ports].never in that box's config.