Skip to content

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.