Installation

This guide covers installing Librescoot on your unu Scooter Pro.

Installer App (Recommended)

The desktop installer downloads firmware, flashes both boards and installs offline maps. You need a USB cable and a screwdriver.

Installation risks and help

The installer is tested on real hardware, but replacing the firmware carries an inherent risk. A failed installation can leave the scooter unusable and require recovery work. For help, ask on Discord.

What you need

  • unu Scooter Pro
  • USB cable (Mini-B on the scooter side)
  • PH2 screwdriver or H4 hex driver for the footwell panel screws
  • About 20 minutes

Download

Version 1.4.6 · All downloads · All releases · Source code

Need the previous installer for a specific reason? Use Installer 1.0.35.

First launch notes

The macOS build is signed and notarized, so it opens with no warning. The Windows build is not yet code-signed.

  • Windows: SmartScreen will flag the installer. Click More info, then Run anyway.
  • Linux: Make the binary executable with chmod +x if needed.

The installer handles driver installation, network setup, and elevation on its own. On Linux, it needs to run as root for USB access. On macOS, it will prompt for your password. On Windows, it installs a USB Ethernet driver automatically.

Manual Installation

If the installer doesn't work for your setup, you can flash both boards manually with a 3.3V serial adapter and U-Boot. This needs physical access to both boards and their UART debug headers, plus comfort with a serial terminal.

Manual installation guide →

Installation complete?

The scooter boots into Librescoot on its own. Continue with the Handbook: Getting started to set up your keycard and check that everything works.

← Services Reference