Ports

Open a localhost server running on one of your computers from another computer or your phone, through an end-to-end encrypted tunnel.

An agent, a Bot or you start a server on one computer, for example npm run dev on localhost:5173. With Ports, that same server opens on your other computers and your iPhone, as if it ran there — without clicking anything. It works across networks (home, office, 4G): nothing needs to be opened on your router.

#Automatic sharing

Automatic is on by default (switch at the top of the Ports panel: plug icon in the title bar). Every few seconds, Neoo looks at the servers listening on this computer and shares on its own:

• servers started from Neoo: agents, Bots and the integrated terminals, whatever the program;
• dev servers started elsewhere by node, bun, deno, python, ruby, php, java, dotnet, go and similar runtimes.

Automatically shared ports show an auto badge under This PC. When the server stops, the share stops too.

Only ports 1024 to 19999 are shared automatically: dev servers use fixed ports there, while higher ports are temporary ports of tools and apps. Never shared automatically either: databases and message brokers (PostgreSQL, MySQL, Redis, MongoDB…), debuggers (Node inspector 9229, browser DevTools 9222), remote desktop and Docker ports, browsers and Neoo's own internal processes. You can still share them by hand.

To stop sharing a port, click Stop: Neoo does not share it again automatically until you restart Neoo or click Share. Turn Automatic off to share only by hand. For a port that is not listed, type it in Other port (e.g. 3000) and click Share.

#On your other computers

With Automatic on, the ports shared by your other computers open on their own: Neoo listens on localhost with the same port number, so http://localhost:5173 works right away in any browser. Hot reload, WebSockets, cookies and OAuth callbacks that use localhost keep working. If that port is already used here, Neoo picks another one and shows local port … (the original port is busy here).

The Ports panel lists them under My other devices, with their path: Direct (peer-to-peer) or Encrypted relay (when a direct connection is impossible), and the round-trip time. Use the buttons to open one in the browser, copy its URL or close it. With Automatic off, click Open next to a port.

#Open a shared port on your iPhone

1. In the Neoo app, open Settings → Ports.
2. Your computers that are online appear with their shared ports — nothing to share by hand on the computer. Tap Open.

The page opens inside the app, with Back, Reload and Close. The connection stays available while the app is open; it is listed under Open connections, where you can close it.

#Security

• End-to-end encrypted. The traffic goes through a QUIC tunnel (TLS 1.3). Each device has its own key, kept in the system keychain. When no direct path exists, the traffic goes through Neoo's relay (relay.ide.neoo.io), which only sees encrypted bytes and only accepts signed-in Neoo devices.
• Your devices only. A computer accepts a connection only from a device of the same Neoo account that asked for its ports in the last 15 minutes. The addresses and keys are exchanged through Neoo's end-to-end encrypted realtime channel, never through a public directory.
• Only what is shared. Other devices reach only the ports shared automatically or by you, only on this computer's loopback. Stopping a share, turning Automatic off or signing out cuts the connections at once.
• Nothing runs without a reason. The tunnel starts only when this computer has a port to share or another of your devices shares one.

#Troubleshooting