The Tokios Connector is a small console app you run on the machine next to your model. It dials out to Tokios over a single WebSocket and forwards requests to your local model — no inbound ports, no public IP, no firewall changes.
You install and pair it from the console’s Setup wizard with a one-time claim code. For the basic path you don’t hand-edit a config file — the connector receives its token securely over the tunnel after you approve the device.
1. Get a claim code
In the console’s Setup tab, click Start pairing (step 1). Tokios shows a claim code like TKS-XXXX-XXXX, valid for about 15 minutes. Keep the tab open.
2. Install and run the connector
On the machine next to your model, run the one-liner the console shows for your OS.
Windows 10 & 11 (x64). In PowerShell: Apple Silicon (arm64). Copy the macOS one-liner shown in the Setup tab and run it in your terminal — it embeds your claim code.
Linux (x64). Copy the Linux one-liner shown in the Setup tab and run it in your terminal — it embeds your claim code.
tokios-connector installed? Skip the installer and pass the claim code directly:
3. Approve the device
The connector dials out and appears in the console. In the Setup tab (or the Connectors tab), approve the device. Tokios then delivers the connector’s token over the tunnel — it is never shown on screen or pasted into a file.
The connector only dials out; it never listens on a port, so your firewall needs no inbound rules.
Advanced: expose multiple models with a config file
To serve several models through one connector, run the connector with a JSON config that defines each upstream instead of pairing a single model. See Connector Config. 
