GestoDS
signed out · —

Fresh Raspberry Pi setup

Put a new Raspberry Pi on a screen and pair it with GestoDS.

Before you start

  1. Use a Raspberry Pi with a reliable power supply and HDMI display.
  2. Flash Raspberry Pi OS Lite (64-bit), enable SSH if needed, and configure Wi-Fi or Ethernet.
  3. Ask a GestoDS administrator for the enrollment token and server host. Keep the token private; it is never displayed by this page.

1. Connect the Pi to the network

  1. Connect Ethernet or configure Wi-Fi, then boot the Pi.
  2. Allow outbound HTTPS and the agent's MQTT connection; no inbound Pi port is required.
  3. Verify the Pi clock is correct so HTTPS and enrollment can validate.

2. Install the player

Run this on the Pi itself, or over SSH. The server URL is filled from the configured public URL when available; replace only the enrollment-token placeholder.

curl -fsSL "https://signage.tlg.ro/install.sh" \
  | sudo bash -s -- "https://signage.tlg.ro" "YOUR_ENROLLMENT_TOKEN"

The installer adds Chromium and the GestoDS player, configures kiosk mode, and reboots. Running it again is safe and upgrades an existing installation in place.

3. Pair the screen

  1. After reboot, read the six-digit pairing code shown on the display.
  2. Open Devices in GestoDS.
  3. Enter the code, choose an unpaired screen, and click Pair.
  4. The Pi downloads its configuration and begins playing the assigned playlist.

4. OTA updates

Devices download a release bundle and verify its checksum before installing it. An older device that does not have the updater must be reinstalled once with the same command; the installer is safe to re-run.

Troubleshooting

  • Confirm DNS, outbound HTTPS/MQTT access, and that the Pi clock is correct.
  • Check that the enrollment token and server URL were copied exactly.
  • If it enrolled but does not pair, use Devices to check the last-seen time and send pull_config or restart_kiosk.
  • For a fresh attempt, re-run the same installer command; it is idempotent.