Admin Guide

Ultiracer Kiosk
Setup Guide

Everything you need to deploy, configure, and monitor Ultiracer kiosk stations across your facility.

What is Kiosk Mode?

Kiosk mode turns any computer with a browser into a ready-to-use Ultiracer station. Users log in by scanning a QR code with their phone — nothing to type, nothing to remember.

Scan & Go

Users authenticate by scanning a QR code. No credentials entered on the kiosk — reducing support burden.

Full Ride Experience

Each kiosk displays live metrics. Sessions are automatically saved and appear in your facility's analytics.

Zero Data Persistence

No user data stays on the kiosk between sessions. Auto-logout, session scrubbing, and wake-lock keep it ready 24/7.

How It Works

The user experience your kiosks deliver

1

QR Code Displayed

The kiosk shows a QR code that refreshes every 12 seconds for security.

2

Scan with App

Users open the Ultiracer app and scan the code. They can also point their phone camera at it — the app opens automatically.

3

Ride

The user is instantly logged in and the ride begins with live metrics on screen.

4

Auto Logout

After the ride, the session is saved. The kiosk automatically logs out and returns to the QR screen — ready for the next user.

Before You Begin

What You Need

A computer with a modern browser

Any OS: Windows, macOS, Linux, ChromeOS. Chrome or Edge recommended.

Internet connection

Required for login and session sync. Ride data buffers locally during brief outages.

Ultiracer + USB cable

Wired USB is recommended for the most reliable connection. The kiosk remembers Ultiracer and auto-reconnects on page refresh.

Admin account

You need SUPER_ADMIN or SPORTS_CENTER_ADMIN access to create kiosks.

1

Create a Kiosk in the Admin Panel

Log in to your Ultiracer admin account and navigate to the Kiosks section in the sidebar.

Admin PanelCreate kioskSetup Code6-char provisionKiosk ScreenEnter code & go

1a. Navigate to Kiosks

In the admin sidebar, click Kiosks. You'll see a list of all kiosks in your facility (or across all facilities if you're a Super Admin).

Total12Online8Offline2In Use1Maint.1Search kiosks...NameDevice IDStatusSports CenterLast SeenStation 1KIOSK-001OnlineMain Gym2m agoStation 2KIOSK-002In UseMain GymNowStation 3KIOSK-003OfflineBranch A3h ago

1b. Click "Add Kiosk"

Click the + Add Kiosk button in the top right. Fill in the details:

Add Kiosk
ultiracer.com/admin/kiosks — Add Kiosk
Station 1 - Cardio Room

A recognizable label you set for management and tracking purposes.

KIOSK-A3F7

Auto-generated by default. You can set a custom ID using your internal asset management rules.

Cardio Room, 1F

A description of the physical space where the kiosk is installed.

RDT Gym - Seoul

The facility where this kiosk will be installed. Pre-filled if you manage only one facility.

Create Kiosk

1c. Get Your Setup Code

After creating the kiosk, a 6-character setup code is automatically generated. You'll see it on the kiosk detail page:

ultiracer.com/kiosks/[id]
Setup Code
A3X9K2

This code is single-use. After the kiosk uses it, click "Regenerate" if you need a new one.

The setup code is single-use. Once the kiosk uses it during provisioning, it's invalidated. If you need to re-provision (e.g., moving the kiosk to new hardware), click the Regenerate button on the kiosk detail page.
2

Run the Kiosk Setup Wizard

On the kiosk computer, open your browser and navigate to https://ultiracer.com/kiosk. The setup wizard will appear on first visit.

2a. Enter the Setup Code

ultiracer.com/kiosk — Setup

Kiosk Setup

Enter the setup code from your admin panel

A3X9K2
Continue

Type the 6-character code from Step 1. Characters are not case-sensitive. Press Enter or click Continue.

2b. Connect Ultiracer

The wizard will walk you through connecting Ultiracer via USB cable. Wired USB is the only supported connection method for the Ultiracer device.

ultiracer.com/kiosk — Connect

Connect Your Ultiracer

Plug in the USB cable and click the button below

Connect Device
USB Connection
  1. Plug the USB cable from Ultiracer into the kiosk computer
  2. Click "Connect Device" on the setup screen
  3. Select the serial port in the browser prompt
  4. Wait for the green "Receiving data" confirmation

Tip: Ultiracer may appear under different names depending on your OS. For example, on ChromeOS it may show as "USB JTAG/serial debug unit (ttyACM0)", while on macOS it may appear with a vendor ID like "(VID:303A)". Look for any USB serial device in the browser prompt.

ultiracer.com/kiosk — Connected

Connected — Receiving Data

Ultiracer is connected and transmitting. You're all set.

USB Auto-Reconnect

The kiosk remembers paired USB devices. On page refresh or reconnection, it automatically detects and reconnects to Ultiracer without requiring the browser's device picker again.

Web Serial requires a one-time permission. The browser will show a device picker dialog. After that, the kiosk remembers Ultiracer and auto-reconnects on page refresh — no re-pairing needed.

2c. Optional: Pair Bluetooth Sensors

After connecting Ultiracer, you can optionally pair external BLE sensors that stay attached to the bike.

ultiracer.com/kiosk — Sensors

Pair Bluetooth Sensors

Optionally pair cadence, power, or heart rate sensors

Pair SensorSkip
Cadence SensorRecommended

Measures pedaling RPM. Recommended — attaches to the crank arm and stays on the bike.

Power Meter

Measures wattage output. Optional — estimated power is calculated from speed if unavailable.

Heart Rate Monitor

Not recommended for shared kiosks — users should bring their own heart rate monitor for hygienic reasons. If you provide one, users can pair it via the mobile app instead.

3

Kiosk is Ready!

Once setup is complete, the kiosk transitions to the idle screen showing a QR code. It's now ready for users — no further configuration needed.

ultiracer.com/kiosk — Idle

Scan to Start Riding

Open the Ultiracer app and tap "Kiosk Login"

QR code refreshes automatically

Recommended: Set Up Kiosk Mode on Your Computer

For a true kiosk experience, configure your computer's browser to launch in fullscreen kiosk mode pointing to . This locks the browser to a single URL and prevents users from navigating away. https://ultiracer.com/kiosk.

Use Chrome's built-in kiosk flag:

chrome.exe --kiosk https://ultiracer.com/kiosk

Launch Chrome in kiosk mode via Terminal:

open -a "Google Chrome" --args --kiosk https://ultiracer.com/kiosk
Linux / ChromeOSFull guide

Use Chrome kiosk flag or configure ChromeOS managed kiosk:

google-chrome --kiosk https://ultiracer.com/kiosk
The kiosk page automatically goes fullscreen on first touch and uses a wake lock to keep the screen on. Setting up OS-level kiosk mode adds extra protection against users navigating away.

Kiosk Management Dashboard

Each kiosk has a detailed management page in the admin panel. Monitor real-time status, view live sessions, track uptime, and manage hardware connections.

Status Overview

The detail page header shows the kiosk's current status, IP address, linked sports center, and last seen timestamp.

OnlineConnected, showing QRIn UseUser session activeOfflineNo recent heartbeatMaintenanceSet by admin
Online

Kiosk is connected and showing the QR code

In Use

A user is currently logged in

Offline

Kiosk hasn't sent a heartbeat recently

Maintenance

Manually set by admin for servicing

Live Session Panel

When a user is actively riding, the dashboard shows a real-time session panel with the user's avatar, elapsed time, and live metrics.

LIVEJohn D.12:34 elapsedSpeed28.5km/hPower185WHeart Rate142bpmCadence88rpm

Speed, power, heart rate, and cadence update every 3 seconds. Session info refreshes every 10 seconds. The elapsed timer updates every second.

Metrics poll at 3s intervals, session info at 10s, elapsed timer at 1s.

Uptime Monitoring

A 24-hour timeline shows kiosk availability in 5-minute buckets. Green = online, orange = unstable, red = outage. The overall uptime percentage is displayed.

24h Uptime96.2%00:0012:00NowOnlineUnstableOutage
Online — kiosk responding normally
Unstable — intermittent connectivity
Outage — no heartbeat received

Cumulative Statistics

Six lifetime metrics for the kiosk: Total Distance, Sessions, Total Hours, Calories, Average Speed, and Top Speed. These aggregate all sessions ever run on this kiosk.

Total Distance12,450kmSessions3,847Total Hours1,256hrsCalories890KkcalAvg Speed24.3km/hTop Speed52.1km/h

Activity Heatmap

A 24-hour bar chart shows usage patterns based on a 30-day rolling average. The peak hour is highlighted to help you identify high-demand time slots.

Activity — 30-Day AveragePeak00:0006:0012:0018:0023:00

Provision Code Management

Copy or regenerate the 6-character setup code. Codes are single-use — regenerate when moving a kiosk to new hardware.

Admin Actions

The kiosk detail page includes a danger zone with powerful admin actions. Use these carefully — they affect the live kiosk immediately.

Danger Zone

Force Clear Kiosk

Ends all sessions, clears challenges

Clear

Force Reload

Forces kiosk to reload configuration

Reload

Maintenance Mode

Prevents new sessions from starting

Force Clear Kiosk

Ends all active sessions, clears pending QR challenges, and refreshes the kiosk page back to idle. Requires typing "CLEAR KIOSK" to confirm. Use when a session is stuck, a user forgot to log out, or the kiosk needs a full reset.

Force Reload

Refreshes the kiosk page without affecting any active sessions or QR challenges. Useful after changing kiosk settings, applying updates, or when the kiosk display is in an unexpected state.

Maintenance Mode

Toggle to prevent new sessions from starting. The kiosk shows a maintenance message instead of the QR code. Existing sessions are not interrupted. Use during hardware servicing or firmware updates.

Force Clear requires typing "CLEAR KIOSK" to confirm. This is a destructive action that cannot be undone.

Facility-Level Analytics

Kiosk session data feeds into your facility's analytics dashboard, giving you a bird's-eye view of usage across all kiosks.

Stats Cards

At the very top of your facility page, you'll see four cards showing the big-picture numbers at a glance — how many people use your facility, how many kiosks are set up, how many members, and how many coaches. Think of it like a scoreboard for your whole facility.

ultiracer.com/admin/facilities/rdt-gym
Total Users
48
Kiosks
12
Members
36
Coaches
8

Kiosks Tab

Click the 'Kiosks' tab to see every single kiosk in your facility listed in a neat table. You can search by name, filter by status (like Online, Offline, or In Use), and click any row to jump to that kiosk's detail page. It's like a roster of all your kiosk stations.

ultiracer.com/admin/facilities/rdt-gym?tab=kiosks
Search kiosks...
All Status
NameStatusLast Seen
Station 1Online2m ago
Station 2In UseNow
Station 3Offline3h ago

Analytics Tab

The Analytics tab combines all riding data from every kiosk into one place. Pick a time range (7, 30, or 90 days), and see totals for sessions, distance, calories, speed, and more. There's a chart showing trends over time and a leaderboard of your top riders.

ultiracer.com/admin/facilities/rdt-gym?tab=analytics
Total Sessions142
Total Distance1,847.3 km
Duration312h 45m
Calories89,240
Avg Speed24.8 km/h
Avg HR128 bpm

Performance Trends

Balance Score
Rides
Distance
Cadence
W1W2W3W4W5W6

Top Riders

Kim Minjae2,847 km
2Park Jisoo2,103 km
3Lee Hyunwoo1,892 km

Security & Privacy

No user data on kiosk

Session tokens are stored in memory only. On logout, all user data (including sessionStorage, localStorage, and cached state) is scrubbed.

One-time setup codes

Provisioning codes are invalidated after first use. Regenerate a new code from the admin panel if re-provisioning is needed.

Rotating QR tokens

QR codes rotate every 12 seconds with 256-bit cryptographic tokens. Each token is single-use — scanning the same code twice returns an error.

MEMBER-only access

Kiosk session tokens are always issued with MEMBER-level permissions, regardless of the user's actual role. This prevents privilege escalation on public devices.

Troubleshooting

QR code not showing
Check internet connection. The kiosk needs to reach the API to generate QR challenges. Verify the connection health indicator.
Device disconnects during ride
For USB: check the cable connection. The kiosk shows a reconnect overlay and attempts auto-reconnect. A reconnect button is also available in the status bar. For BLE: ensure Ultiracer is powered and in range.
Setup wizard appears again
The config cookie expires after 90 days, or validation failed. Re-enter the setup code (regenerate one first from the admin panel).
User can't scan QR code
Make sure the user has the Ultiracer app installed and is logged in. They can scan with the in-app camera (Ride tab → Kiosk Login) or with their phone's default camera — the app opens automatically via deep link.
Kiosk shows as Offline in admin
The kiosk sends heartbeats every 60 seconds. If it hasn't sent one recently, it appears offline. Check that the browser tab is still open and the computer hasn't gone to sleep.
How do I move a kiosk to different hardware?
Go to the kiosk detail page, regenerate the provision code, then run the setup wizard on the new hardware using the new code. The old hardware will stop functioning as that kiosk.
What does Force Clear do?
Force Clear ends all active sessions on the kiosk, clears pending QR challenges, and resets it to the idle QR screen. You must type "CLEAR KIOSK" to confirm.
How do I put a kiosk in maintenance mode?
Go to the kiosk detail page, scroll to Admin Actions, and toggle Maintenance Mode on. The kiosk will show a maintenance message and reject new sessions until you toggle it off.

Ready to set up your first kiosk?

Get a demo license and have your first kiosk running in minutes. Our team will walk you through everything.