> For the complete documentation index, see [llms.txt](https://8bitmods.gitbook.io/manuals/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://8bitmods.gitbook.io/manuals/reference/error-messages.md).

# Error messages

Messages shown on the display, and what to do about them.

## Storage

| Message                                              | Cause and fix                                                                                |
| ---------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| Can't find SD or USB device! Please plug in storage. | No storage found at boot. Check the card is inserted and formatted FAT32 or exFAT.           |
| SD Error, Please run scandisk!                       | The file system is damaged. Run a disk check on a PC, or reformat and restore from a backup. |
| Out of space or SD corrupt.                          | Creating a card failed. Free space or check the file system.                                 |
| File create failed. Repair or replace SD.            | The storage rejected a write. The card may be failing.                                       |
| Couldn't create VMC. Check your storage.             | Generic card creation failure.                                                               |
| Your storage does not support Direct SD!             | The storage cannot be used for cards larger than 8 MB. Use a microSD card.                   |
| Invalid path.                                        | The card name contains characters the file system does not allow.                            |

## Templates

| Message                       | Cause and fix                                                                                            |
| ----------------------------- | -------------------------------------------------------------------------------------------------------- |
| Template could not be opened. | No template exists for this size. See [Template cards](/manuals/virtual-memory-cards/template-cards.md). |
| Template is the wrong size.   | The template file is not exactly the card size.                                                          |
| Template failed.              | The template could not be copied. Check free space.                                                      |

## Firmware update

| Message                          | Cause and fix                                                                            |
| -------------------------------- | ---------------------------------------------------------------------------------------- |
| Download Error, Please retry!    | The download from the update server failed. Check the internet connection and try again. |
| Checksum Error, Please try again | The downloaded file was corrupt. Try again.                                              |

## Wi-Fi and cloud

| Message                              | Cause and fix                                                                   |
| ------------------------------------ | ------------------------------------------------------------------------------- |
| Wifi Error, Connection failed!       | Wrong password or the network is out of range. Run **Menu > Wifi Setup** again. |
| Wifi off! Please connect wifi!       | A cloud sync was requested with Wi-Fi off. Select **Menu > WiFi** first.        |
| Cloud not init, Please wait a moment | The cloud service is still starting after boot. Wait a few seconds.             |
| Cloud Busy! Hold to cancel           | A backup is in progress. Hold a button to cancel it.                            |

## Other

| Message                     | Cause and fix                                                                  |
| --------------------------- | ------------------------------------------------------------------------------ |
| Wait for flush to complete! | The card is still being written. Wait for the **Writing...** screen to finish. |


---

# 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://8bitmods.gitbook.io/manuals/reference/error-messages.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.