Network & ports
flowchart LR
ST["<span style='color:#111111'>nestris-station</span>"]:::core -- "TCP 1883 · MQTT" --> MQ["<span style='color:#ffffff'>Mosquitto</span>"]:::ext
ST -- "TCP 7990 · HTTP PUT .ngf" --> LTM["<span style='color:#111111'>NestrisLTM</span>"]:::ltm
MQ <-- "TCP 1883 · MQTT" --> LTM
LTM -- "TCP 5432 · SQL" --> PG[("<span style='color:#ffffff'>PostgreSQL</span>")]:::ext
TERM["<span style='color:#111111'>nestris-terminal bridge<br/>127.0.0.1:7991</span>"]:::term -- "TCP 7990 · REST" --> LTM
BR["<span style='color:#ffffff'>Browsers · OBS · displays</span>"]:::ext -- "TCP 7990 · HTTP + WebSocket" --> LTM
RD1["<span style='color:#111111'>Reader</span>"]:::rfid -- "USB serial 115200" --> ST
RD2["<span style='color:#111111'>Reader</span>"]:::rfid -- "USB serial 115200" --> TERM
LTM -. "HTTPS 443 · update check (optional)" .-> GH["<span style='color:#ffffff'>GitHub</span>"]:::ext
classDef ltm fill:#f5b800,stroke:#7a5c00,color:#111,stroke-width:2px
classDef core fill:#22d3ee,stroke:#0e7490,color:#111,stroke-width:2px
classDef term fill:#a78bfa,stroke:#6d28d9,color:#111,stroke-width:2px
classDef rfid fill:#f472b6,stroke:#be185d,color:#111,stroke-width:2px
classDef ext fill:#64748b,stroke:#334155,color:#fff,stroke-width:2px
Port matrix
| Port |
Protocol |
Service |
Listens on |
Clients |
Exposure |
| 7990 |
HTTP / WebSocket |
NestrisLTM |
host, 0.0.0.0 |
stations, terminal, browsers, OBS |
local subnet (firewall rule) |
| 1883 |
MQTT |
Mosquitto |
host |
stations, NestrisLTM |
local subnet (firewall rule) |
| 5432 |
PostgreSQL |
PostgreSQL |
host |
NestrisLTM |
local only by default |
| 7991 |
HTTP / WebSocket |
Terminal bridge |
127.0.0.1 |
the kiosk window only |
not reachable from the network |
| 443 |
HTTPS |
GitHub |
– |
NestrisLTM update check |
outgoing, optional |
| – |
USB serial, 115200 8N1 |
RFID reader |
– |
station or terminal |
local USB |
HTTP surface of NestrisLTM
| Path |
Access |
Purpose |
/ |
admin login |
Admin UI |
/o/<slug> |
public (LAN) |
OBS overlay of a scene |
/view/highscore |
public (LAN) |
Highscore and bracket display |
/view/tournament-admin |
admin login |
Tournament console |
/status |
public (LAN) |
Status page |
/api/terminal/v1/* |
token terminal |
Player terminal API |
/api/stations/{id}/games/{game_id}/ngf |
token stations |
Recording upload |
/api/scenes/{slug}/rounds |
token scenes |
Start a new round (Stream Deck) |
/api/health |
public (LAN) |
Health check (database, broker) |
/api/diagnostics |
admin or local |
Diagnostics and logs |
/ws/live, /ws/kiosk, /ws/scene/{slug} |
public (LAN) |
WebSocket feeds for the UI, displays and overlays |
Token scopes
| Scope |
Used by |
admin |
Full administrative API access |
players:write |
Tools that create or edit players |
games:write |
Tools that create or edit games |
stations |
Capture stations (recording upload) |
scenes |
Stream Deck / round control |
terminal |
The player terminal |
Tokens start with nltm_ and are created in the admin UI under Einstellungen → API-Tokens.