Event setup¶
This guide takes you from empty tables to a running tournament. Plan about one hour for the first setup. Later events reuse the installation and only need an event created.
flowchart LR
A["<span style='color:#ffffff'>1 · Network</span>"]:::ext --> B["<span style='color:#111111'>2 · Host PC</span>"]:::ltm --> C["<span style='color:#111111'>3 · Tokens & event</span>"]:::ltm --> D["<span style='color:#111111'>4 · Stations</span>"]:::core --> E["<span style='color:#111111'>5 · Terminal</span>"]:::term --> F["<span style='color:#ffffff'>6 · Screens & OBS</span>"]:::ext --> G["<span style='color:#111111'>7 · Test game</span>"]:::ltm
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 ext fill:#64748b,stroke:#334155,color:#fff,stroke-width:2px
1 · Network¶
- Put a dedicated switch (or VLAN) in place for the tournament and connect the host PC, stations, terminal and stream PC by cable if possible.
- Give the host PC a fixed IP address, for example
192.168.50.10. Every other device points to it. - No internet is needed during the event. It is only needed to download updates.
2 · Host PC¶
- Download
NestrisLTM-Setup-<version>.exefrom the latest release and verify it. - Run the installer as the Windows user who will run the tournament, then:
- keep PostgreSQL 18 and Mosquitto ticked (or untick them to use existing servers),
- tick autostart and the firewall rules (TCP 7990 and 1883, local subnet only),
- choose and write down the PostgreSQL password.
- Wait for the final check page. Database, broker and port must all be green.
- NestrisLTM opens. Create the first admin account.
Health at a glance
The tray icon is green when database and broker are fine and orange when one is missing. Hover it for details, or run nestris-ltm check.
3 · Tokens & event¶
- Einstellungen → API-Tokens: create one token with scope
stationsand one with scopeterminal. Copy them now, because they are shown only once. - Events: create the event (name and time window) and activate it. The highscore, bracket and overlays always show the active event.
4 · Stations¶
On each Debian station:
/etc/nestris-station/station.toml (minimal)
[station]
id = "station-1" # unique per station
name = "Station 1"
[capture]
device = "/dev/v4l/by-id/usb-…-video-index0" # see: nestris-station list-devices
[rfid]
port = "/dev/serial/by-id/usb-…"
[mqtt]
host = "192.168.50.10" # host PC
live_max_hz = 60
[host]
url = "http://192.168.50.10:7990"
token_file = "/etc/nestris-station/host.token" # token with scope "stations"
sudo nestris-station check-config # validates the file, masks secrets
sudo nestris-station test-mqtt # proves the broker is reachable
sudo systemctl enable --now nestris-station
- The station appears on the NestrisLTM dashboard within seconds.
- Plug in the NES capture and the reader. The dashboard shows
capture: ok,rfid: okand the lock state.
5 · Registration terminal¶
- Install
RetroverseTerminal-Setup-<version>.exeon the touch PC. It needs no admin rights. - Enter the host URL
http://192.168.50.10:7990and theterminaltoken in the wizard. - Plug in the reader. The terminal finds it automatically.
- Harden the kiosk: automatic sign-in, no sleep, no notifications, edge swipe off.
6 · Screens & OBS¶
| Output | URL |
|---|---|
| Hall display (highscore + bracket) | http://192.168.50.10:7990/view/highscore |
| Only highscore / only bracket | …/view/highscore?only=highscore / ?only=bracket |
| OBS-transparent display | …/view/highscore?transparent=1 |
| Stream overlay of a scene | http://192.168.50.10:7990/o/<scene-slug> |
| Admin from another PC | http://192.168.50.10:7990/ |
Create the scenes under Szenen. See Streaming & OBS.
7 · Test game¶
- Register a test player at the terminal and get a card written.
- Tap the card at a station. The reader shows the nickname.
- Play a short game. The overlay shows it live, and after game over the highscore updates.
- Open the game in the admin UI and replay it to confirm the recording arrived.
- Hide or delete the test player before the doors open.
During the event¶
- Watch the dashboard: stations, capture state, running games, log.
- Games flagged cheat or invalid have their own filter. Review them and use the replay as evidence.
- Back up the database before and after every day:
& "C:\Program Files\PostgreSQL\18\bin\pg_dump.exe" -U postgres -Fc -f "D:\Backup\nestrisltm-$(Get-Date -f yyyyMMdd-HHmm).dump" nestrisltm
Troubleshooting¶
| Symptom | Check |
|---|---|
| Tray orange, database red | Service postgresql-x64-18 running? Password in the config right (nestris-ltm configure --db-password)? |
| Tray orange, MQTT red | Service Mosquitto Broker running? Look at C:\ProgramData\mosquitto\mosquitto.log. |
| Tray red / port in use | Another program uses 7990. nestris-ltm check names it; change it with --http-port. |
| Station doesn't appear | Station mqtt.host = host IP, same topic_prefix, firewall rule for 1883, same subnet. |
| Recordings missing | Station host.url and token (scope stations), firewall rule for 7990. The station retries from its queue. |
Reader shows PC getrennt |
USB cable or port; on the station check status.rfid. |
Station reports rfid: outdated |
The reader runs old firmware. Flash the current nestris-rfid-reader release. |