The Tokios Connector is a lightweight console app that creates a secure outbound WebSocket tunnel between your local model server and the Tokios gateway. Install it on any machine that runs your model — no inbound firewall rules required.
Download the Connector
Visit the Tokios website and download the binary for your operating system.
Supported: Windows 10 & 11 (x64)Download tokios-connector.exe from the Tokios website and place it in a directory of your choice — for example, C:\tokios\.Create your config fileIn the same directory as the binary, create a file named tokios.json:{
"tunnel_token": "tt_your_token_here",
"upstream": "http://localhost:11434"
}
tokios-connector.exe --config tokios.json
Supported: Apple Silicon (arm64)Download tokios-connector from the Tokios website and place it in a directory of your choice — for example, ~/tokios/.Create your config fileIn the same directory as the binary, create a file named tokios.json:{
"tunnel_token": "tt_your_token_here",
"upstream": "http://localhost:11434"
}
chmod +x tokios-connector && ./tokios-connector --config tokios.json
Supported: Linux (x64)Download tokios-connector from the Tokios website and place it in a directory of your choice — for example, ~/tokios/ or /usr/local/bin/.Create your config fileIn the same directory as the binary, create a file named tokios.json:{
"tunnel_token": "tt_your_token_here",
"upstream": "http://localhost:11434"
}
chmod +x tokios-connector && ./tokios-connector --config tokios.json
tokios.json file tells the connector two things: how to authenticate with the Tokios gateway, and where your local model server is listening.
{
"tunnel_token": "tt_your_token_here",
"upstream": "http://localhost:11434"
}
| Field | Description |
|---|
tunnel_token | Your unique token from the Tokios dashboard. See Getting your tunnel token below. |
upstream | The local URL of your model server. Change the port to match your backend (see Supported Backends). |
Getting your tunnel token
- Sign up or log in at the Tokios dashboard.
- Navigate to Connectors → New Connector.
- Copy the generated
tunnel_token and paste it into your tokios.json.
Successful Startup
When the connector starts and the tunnel is live, you’ll see output similar to:
Tokios Connector v1.x.x
Connecting to api.tokios.com...
Tunnel established. Your models are reachable.
Tunnel established, your local model server is reachable through api.tokios.com. You can now register your model deployment in the dashboard.
The connector does not listen on any port. It only dials out — your firewall needs no changes.
