Getting started
Set up your keycards and check the scooter after installing Librescoot.
What happens after flashing
After installation, the scooter reboots automatically. The screen is initially black, then shows the cluster in park mode.
Setting up keycards
When using the Installer
Installer 1.3+ On a fresh installation with the recommended Installer, you set up keycards before leaving the Installer. Select Start learning, hold each card against the reader at the front of the dashboard, then select Finish. The Installer counts the cards and activates them when you finish. You need at least one keycard unless you explicitly skip this step.
Cards set up this way are user cards that lock and unlock the scooter; you do not need a master card for that. You can reuse the card from your starter kit because Librescoot reads the same NFC cards as the original firmware. A fresh installation removes previously stored cards, so register every card you want to keep using.
Optionally, Add master card (advanced) in the Installer sets up a separate master card. It lets you teach in more keycards later without the Installer or command line, but it cannot unlock the scooter itself. More on Custom keycards.
To unlock the scooter, hold a user card against the card symbol for about a second. The status LED lights up yellow, then briefly green. The scooter is now unlocked and in park mode.
A short red flash means the card was not authorised. (While teaching in cards, a red flash can also mean the card is already stored.) If the status LED doesn't react at all to a card, see Troubleshooting.
After a manual installation
If you installed the scooter manually and no keycards were retained, it waits for a master card on first boot instead. You need two different cards: a master card to control learning mode and at least one user card to lock and unlock the scooter.
The status LED on the right side of the display blinks. Hold the master card against the card symbol to the left of the display for about a second. The LED briefly lights up, and the card is stored as master.
Tap the master card again. The turn signals come on and stay on; this is the learning-mode indicator. The status LED goes amber and stays amber while learning mode is active. Tap a second, different card: the status LED goes green for half a second and then back to amber, and the user card is held for saving. Tap the master card once more to leave learning mode. The turn signals go out, and only then is the user card saved, so do not skip this step.
Quick function check
Before your first ride, check the display and controls.
Display and status bar
The display should show:
- The main battery's charge level in the top left of the status bar. There is one icon per installed, detected battery; on stock hardware only the front slot is wired, so you normally see a single icon, and a wired rear battery adds a second.
- The current time at the top center.
- At the top right: cellular reception, GPS, Bluetooth, temperature and OTA status, depending on your hardware and settings. Cellular reception requires a SIM card.
- A red (P) symbol for the parking brake below the speedometer, indicating park mode.
- A statistics row at the very bottom with trip duration (DURATION), average speed (Ø SPEED), trip distance (TRIP) and total distance (TOTAL).
The full icon legend is on The display.
Checking versions
In park mode, hold both brake levers at the same time for about three seconds. A version box appears in the bottom right of the display, listing the versions of the scooter's four components: main computer (MDB), dashboard computer (DBC), Bluetooth module (nRF), and motor controller (ECU).
1.3+ The same versions and device identifiers are listed permanently under .
If a component shows a dash or "unknown", see Troubleshooting.
Handlebar and switches
With a battery inserted and in park mode, you should get the following responses:
- Pushing the indicator switch left or right blinks the corresponding indicators on the scooter and shows an arrow at the bottom of the display.
- Pressing the horn produces an audible honk.
- Pressing the seatbox switch unlatches the seat with an audible click.
If any of these doesn't react, the scooter probably didn't reach full park mode. The battery may be missing, or the internal AUX cell may be flat. More on States and Battery & energy.
A short test ride
If the checks pass, take a short test ride in a quiet area.
Fold the side stand in. The (P) symbol disappears, the scooter switches to drive mode. Ride at walking pace with your eyes on the road, not the display, and try each brake briefly:
- Both brakes should bite evenly and predictably.
- Then stop, park, and check the display: the speedometer showed your speed while riding, and the energy gauge reacted to your inputs – accelerating moves the bar toward DISCHARGE, braking or coasting toward REGEN, with the current power value in kW below.
Once everything checked out, fold the side stand out again and lock the scooter with the keycard.
If something doesn't add up
For boot failures, a black display, a persistent maintenance screen or an unresponsive keycard or battery, see Troubleshooting.
If the problem persists, ask for help on Discord.
What's next?
- The display has the cluster anatomy and a full icon legend.
- If you selected a map region in the Installer, maps and routing data are already installed – confirm under . Otherwise, Set up maps and navigation explains how to get offline maps and routing data onto the scooter.
- Changes from scooterOS covers what's different from the original unu firmware.
Dashboard keycards (1.4 preview)
Under , enroll unlock cards, store a teach-in card and remove cards. New unlock cards are queued during enrollment and saved when you choose Done. Removing the last unlock card asks for confirmation.