> For the complete documentation index, see [llms.txt](https://docs.wingbits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wingbits.com/wingview/troubleshooting/recovery-guide.md).

# Recovery Guide

Restore updates when WingView rejects a valid firmware build.

Restart WingView when an update fails but the board otherwise works. This restores the previous firmware version. Your Wi-Fi, API key, locations, and maps remain saved.

### When to use this guide

Use these steps when an update fails with a message that the file is invalid or the build is not accepted. Use them only if WingView otherwise works normally.

### Restart WingView

1. Open WingView's web page.
2. Select **Restart** at the bottom of **home**.
3. If you cannot open the page, unplug the board.
4. Wait five seconds.
5. Plug the board back in.

The bootloader performs the repair before firmware starts. Either restart method has the same result.

After restarting, WingView runs the previous firmware version. You can install updates again.

{% hint style="success" %}
A restart never erases your Wi-Fi, API key, locations, or maps.
{% endhint %}

### Install the update again

1. Wait for WingView to start and show aircraft.
2. Open the web page.
3. Go to **firmware**.
4. Confirm that the displayed version is older. This is expected.
5. Select **Check for update**.

The update should now install normally.

### Why this happens

WingView keeps the previous firmware until a new version proves it can run. A new version gets about one minute to confirm itself.

Until confirmation completes, WingView does not accept another update. This protects the known-working version.

An unconfirmed update can leave WingView working normally while it refuses every new update. Restarting returns to the previous version and clears that state.

### If restarting does not help

A continued update failure has a different cause. Send the log to support:

1. Open the board's web page.
2. Go to **log**.
3. Select **Show additional details (for support)**.
4. Select **Copy all**.

The log removes your Wi-Fi name, API key, passphrase, and coordinates before copying.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.wingbits.com/wingview/troubleshooting/recovery-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.