Documentation|Back to Kolva Club

Kiosk Setup

Set up a tablet at your venue entrance for self-service athlete check-in. Athletes tap their name to mark themselves as present.

What you need

  • A tablet (iPad, Android tablet, or any device with a web browser)
  • An internet connection at your venue

Setting up

  1. Go to Settings → Kiosk and configure the optional 4-digit PIN (used for navigation, e.g. exiting kiosk mode — child-deterrent only, not a security boundary).
  2. Tap Generate Activation Code. You get a one-time code valid for 24 hours.
  3. On your tablet, open a browser and go to kolva.club/kiosk.
  4. Enter the activation code. The kiosk exchanges it for a unique device token and stores it locally.
  5. The kiosk now shows today's sessions automatically. The activation code is consumed — generate a new one for each additional device.

Per-device tokens (security)

Each kiosk gets its own unique authentication token after activation, instead of sharing one club-wide secret. This means:

  • Each device shows up in your kiosk list at Settings → Kioskwith a friendly name and a “Last seen” timestamp.
  • If a device is lost or compromised, you can revoke it individually without affecting other kiosks.
  • Activation codes are single-use and time-limited — sharing one with a parent by mistake doesn't give them long-term access.

How athletes check in

  1. The tablet displays a list of today's sessions
  2. Athletes select their session
  3. They find and tap their name
  4. A confirmation appears and their attendance is recorded

Offline support

The kiosk works offline as a PWA. If the internet drops during a session, check-ins are stored locally and synced when the connection returns — each queued check-in replays using the device's stored token.

Migrating from older kiosks

Devices set up before per-device tokens (early 2026) need to re-activate. Generate a fresh activation code from Settings → Kiosk and re-enter it on each kiosk. Any check-ins queued offline by an older device are automatically dropped on first replay since they can't be authenticated — check that no offline-queued items are pending before re-activating.

Tips

  • Mount the tablet at the entrance for easy access
  • Use "Guided Access" on iPad or "Screen Pinning" on Android to lock the tablet to the kiosk screen
  • Give each device a memorable name when activating (e.g. “Front desk iPad”) so you can identify it later in the kiosk list