Skip to content

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>.exe from 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 stations and one with scope terminal. 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:

sudo apt install ./nestris-station_<version>-1_amd64.deb
sudoedit /etc/nestris-station/station.toml
/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: ok and the lock state.

5 · Registration terminal

  • Install RetroverseTerminal-Setup-<version>.exe on the touch PC. It needs no admin rights.
  • Enter the host URL http://192.168.50.10:7990 and the terminal token 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.