Offline use & connectivity

Riding, offline navigation, the alarm and Bluetooth or USB updates work without a SIM or cloud account. Add cellular connectivity for automatic downloads and remote access.

What works without a SIM

These functions run locally:

  • Riding and the dashboard, including keycards, vehicle data, settings, and the built-in alarm.
  • GPS position and time. The GPS receiver does not need a SIM card.
  • Offline maps and navigation, once the map and routing packages for your region are installed.
  • Firmware updates over Bluetooth from a nearby phone.
  • Maps, routing data, firmware, and recovery over USB through Update Mode.

Automatic mobile downloads and remote access require an internet connection.

Maps and navigation are local

Offline map tiles draw the map on the display. Offline routing data calculates a route and provides turn-by-turn instructions. They are separate packages, and you need both for the complete offline navigation experience.

If you chose a region in the Installer, both are normally installed during setup. Check them under Menu → Info → Maps. The Navigation page explains daily use and map settings; the map and routing setup guide covers the files themselves.

Updates without mobile data

Bluetooth for routine firmware updates

1.2+ A nearby phone can transfer firmware to both scooter computers over Bluetooth. For normal updates, use a small delta artifact in the supported mobile app. Keep the phone close until the transfer finishes; the links and complete procedure are on Updates.

Use Update Mode for the larger map and routing packages. For firmware transfers, see Updates.

Update Mode for large files and recovery

Update Mode turns the scooter into a removable USB drive. You connect a computer, copy firmware into system-update/ or map and routing files into maps/, safely eject the drive, and let the scooter process the files.

This is the offline path for installing maps, changing release channel, using a full image, or recovering when a Bluetooth update is not suitable. The Update Mode guide has the safe, step-by-step procedure.

GPS time is offline too

The scooter has no real-time clock that keeps accurate time while it is powered down. Instead, the dashboard synchronises the clock from GPS when a fix is available. A SIM card is not part of that process.

After a fresh start or a long time indoors, take the scooter outside with a clear view of the sky and give it time to find satellites. Until then, the time may be missing or wrong. You can hide the clock under Menu → Settings → Appearance → Status Bar → Clock; the other display choices are covered on The display.

If you want the scooter online

An internet connection adds automatic firmware and map downloads, online map tiles and remote routing. Internet access alone is enough for automatic system updates; it does not require a cloud account.

There are two cellular routes:

  • Keep the factory SIM: Sunshine offers paid connectivity plans for compatible factory SIMs. Sign in at sunshine.rescoot.org, add your scooter, and open its connectivity setup. Sunshine securely links and checks the scooter before offering a plan.
  • Use your own SIM: fit a SIM adapter to the main computer and use a data plan from your own provider. This is a hardware modification involving soldering; the online-scooter guide covers the safety steps, SIM choice, APN, and PIN configuration.

With your own SIM, the provider charges you directly and no factory-SIM connectivity subscription is needed. In either case, mobile data use depends on what you enable, especially full firmware images, map downloads, and online maps.

Internet, cloud, and the on-scooter client

The SIM provides internet access. A cloud service provides status and remote controls, with a client on the scooter carrying data and commands.

  • Sunshine is the community-run web service for scooter status, position, trips, and remote controls.
  • radio-gaga is the on-scooter client built for Sunshine. It sends telemetry and events over MQTT, receives remote commands, and buffers data while the connection is unavailable.
  • uplink-service is an alternative WebSocket client for the Librescoot uplink-server. It carries telemetry, events, logs, and remote commands and is useful when you run that server yourself.

Configure the client that matches your backend. To connect to Sunshine, generate an installer link in Sunshine Account settings; developer mode is not required. Copy its bootstrap token or online installer link into Cloud → Connect to Sunshine in LSD. Accept any pending scooter claim in Sunshine to finish setup. You can also run the installer command in the scooter's shell. If the scooter cannot reach Sunshine yet, use the separate offline setup command in Account settings.

For a custom backend, install the matching radio-gaga or uplink-service configuration file instead.

WireGuard is a separate, advanced option for a private network connection to the scooter. Its configuration files can be moved through Update Mode.

When a connection is not working

  • The clock is wrong: this is usually a missing GPS fix, not a missing SIM. Move outdoors and wait for the GPS indicator.
  • A Bluetooth update will not start: make sure the phone is paired, keep it close to the scooter, and check the recovery advice on Updates.
  • The scooter has a SIM but no internet: open Menu → Info → Connectivity. With your own SIM, also check the APN and PIN from the setup guide.
  • Internet works but Sunshine stays offline: the cellular connection and cloud client are separate. Check that radio-gaga is configured for the scooter and running.
  • Update Mode files are ignored: safely eject the drive before leaving the mode, then check ums_log.txt. More checks are in the Update Mode guide.