Troubleshooting

Onewheel: firmware update won't show up or keeps failing

The app never offers the update, or it starts and fails. Onewheel's fixes: update the app, keep the phone close, start near 50 percent battery, and forget and reconnect the board.

The Pedalwise team started this page from official manuals, support pages and repair videos. Fixed this yourself, or spotted something wrong? Help improve it.

You know there is new firmware for your board, but the Onewheel app never offers it, or the update starts and then fails. The fixes apply to Onewheel boards in general (firmware won't update article, how to update article). The short answer: almost always the app, the phone's connection or the battery level, not the board.

Only install firmware through the official Onewheel app. Never install unofficial firmware or try to roll firmware back, and never use an update to change how pushback or other safety alerts behave. Read Onewheel riding safety and firmware.

Most likely cause

The update runs over Bluetooth from the app. Most failures come down to that link: an old app version, no internet on the phone, pop ups left open, Bluetooth off, the phone too far away or the app closed during the update (firmware won't update).

Other causes to rule out

  • Battery level. Start near 50 percent. Below that you may be asked to plug in. Above it, unplug the charger, because plugging in a board above 50 percent could shut it off mid update (how to update).
  • A dismissed prompt. Dismissing the notification may mean waiting for the next release.
  • Board position. Place the board in the ready to ride position, on a stand or on its side (firmware won't update).

How to confirm

  1. Update the Onewheel app from your phone's app store.
  2. Turn the board on and connect it in the app. Check the phone has internet.
  3. Close any pop ups and leave the app on the My Boards page for about 2 minutes (firmware won't update).
  4. Check the board's battery is near 50 percent and the charger matches Onewheel's rule above.
  5. Keep the phone within 5 feet of the board with the app open the whole time. The lightbar flashing during the update is normal (how to update).

Fix options

Clear the app side (easy)

Steps 1 to 3 above. Charge the phone too.

Forget and reconnect the board (easy)

Onewheel's steps: with the board on, open the menu and tap Disconnect, then on My Boards tap the i next to your board, Forget, then Remove, and connect again (firmware won't update).

Contact Onewheel support (pro)

Interrupting an update could corrupt the board's current firmware (how to update). If the board misbehaves after a failed update, or won't update after the steps above, contact support and send diagnostics if the app can still connect (FAQ).

When to get a pro

A board that won't power on, won't connect or shows errors after a failed update. See update e-bike firmware for general tips and Onewheel troubleshooting.

Sources

Stuck after these checks? Find a shop near you.

Need a pro?

If these steps didn't fix it, find a shop near you in our partner network of shops that work on electric rides.

Talk

Questions, things that worked for you, or something that looks wrong on this page.

Sign in to join the conversation.

CC BY-NC-SA 4.0Text by Pedalwise and contributors, shared under CC BY-NC-SA 4.0. Linked videos and manuals keep their own terms. How to reuse it