Skip to content

Overview ​

Neutrino is a hub, the agents it manages and the clients that connect to the hub. This page shows where each one goes, first on one computer, then on several machines. A later section shows how a phone or a laptop reaches them from outside your home.

One computer ​

The hub and an agent install together on one computer that stays on. The agent runs the computer's services: terminals, AI sessions, an editor, the desktop and shared files. Your phone and your laptop each run a client. A client connects to one port of the computer, the hub's port 8443.

One computer runs the hub and an agent; a phone and a laptop connect to its port 8443

How a client reaches the computer's services ​

When you open a service, the client opens a port for it on the loopback address of your phone or laptop. A connection to that port goes over the client's one connection to port 8443. The hub passes it to the agent of the machine that runs the service. Port 8443 is therefore the one port the computer opens to clients.

Several machines ​

Each further machine at home gets an agent of its own, and that agent connects to the hub's port 8443. The machine's services then appear in the clients beside the first computer's. A client still connects to the hub alone, so it reaches every machine through that one port.

Three machines at home, each with an agent, and a phone outside that reaches the hub's port 8443 by any of the ways in

The hub's Clients page sets which machines and which kinds of service each client can open.

Reaching home from outside ​

At home, a client reaches the hub over your network. From outside, it uses a way in:

  • Direct needs a public IPv4 or IPv6 address at home and a port forward to port 8443 on the home router.
  • SSH Relay needs a server with a public address that you run, such as a rented VPS. Its public port leads to port 8443.
  • NetBird needs an account with a NetBird management server, such as netbird.io. The mainland edition leaves it out.
  • EasyTier needs an account on an EasyTier console, or the address of a machine already on your EasyTier network.

Several ways in can be on at once, and a client uses whichever one reaches the hub. Choose a way in compares them for your home.

The parts and the hub's layers ​

PartInstalls onDoes
Hubone computer that stays on, with Linux, macOS or Windowsruns the panel on ports of its own, accepts agents and clients on port 8443, and publishes services
Agenteach machine that runs services, the hub's own computer among theminstalls the modules the panel turns on, and runs terminals and the desktop
Clientyour laptop with Linux, Windows or macOS, or your Android phoneopens what the hub publishes to it, at home and from outside

The hub itself has layers, and each one is set on its own panel page:

LayerWhat it does
ModePlaces the hub's computer in your network. Server runs on every system, Router on Linux, and Side gateway on Linux in the full edition.
AccessTurns on the ways in from outside: Direct, SSH Relay, NetBird and EasyTier.
ProxySends chosen traffic through exit nodes: the hub's own, and in Router and Side gateway that of the devices behind it. Full edition only.
AI gatewayOne address in front of your API keys and subscriptions, for the AI tools on every machine and client.

Network describes each mode and how to change it. Security explains why the hub runs as root, where it keeps your keys, and what Direct opens.

Neutrino · personal developer infrastructure