# Error codes and troubleshooting in Mbox Viewer

:::callout
**Seeing an error code while loading a mailbox?** Mbox Viewer runs entirely in your browser, so you can fix most issues yourself without any data leaving your device. Find your code below and follow the steps.
:::

## How to find an error code

Every error shows a code such as `ERR-PARSE-001`. The same codes are listed under the Support tab in the extension. While loading, the progress window also shows a live log with bytes, mails per second, encoding and timing. Open DevTools with F12 to see the full log and attach it when you report a bug.

## ERR-PARSE-001: the file cannot be read

:::warn
**Cause.** The file could not be parsed. It is most likely corrupt, truncated, or not a valid MBOX or EML format.
:::

:::howto title="Fix ERR-PARSE-001"
1. Check that the file downloaded completely. An interrupted download from Google Takeout or a mail client is the most common cause.
2. Re-export the mailbox from the source, for example through Takeout for Gmail or File export in Thunderbird.
3. Check the format. Supported types are `.mbox`, `.mbx`, `.eml`, `.emlx`, Maildir folders and compressed `.mbox.gz`.
4. Open a small test file to confirm the viewer itself works. If it does, the original file is the problem.
:::

## ERR-DB-001: the local database cannot be opened

:::warn
**Cause.** Mbox Viewer stores your mails locally in IndexedDB. This error means storage is full or IndexedDB is blocked by the browser or a policy.
:::

:::howto title="Fix ERR-DB-001"
1. Check your browser storage, in Chrome through Settings, Privacy and security, Site settings.
2. Close other tabs that have the extension open. Several tabs at once can lock the database.
3. Use Clear database in the extension and load the mailbox again.
4. Allow persistent storage when the browser asks, otherwise the browser may evict your data under storage pressure.
5. Do not test in an incognito window, where IndexedDB is often limited or temporary.
:::

## ERR-MEM-001: the file is too large for memory

:::warn
**Cause.** The file does not fit in the available memory.
:::

:::howto title="Fix ERR-MEM-001"
1. Let the viewer switch to database mode automatically. For large files this happens on its own.
2. Close heavy tabs and programs to free up memory.
3. If it still fails, split the mailbox into smaller parts.
:::

## ERR-FILE-TOO-LARGE: file larger than 2 GB

:::warn
**Cause.** The file exceeds the 2 GB limit.
:::

:::howto title="Fix ERR-FILE-TOO-LARGE"
1. Split the MBOX file into smaller parts with an mbox splitter.
2. Load the parts one by one. Tags and notes are kept per mail.
:::

## ERR-UNSUPPORTED: file format not supported

:::warn
**Cause.** The format is not supported yet, for example `.pst` or `.ost` from Outlook.
:::

:::howto title="Fix ERR-UNSUPPORTED"
1. Export to MBOX in Outlook first, or use a PST to MBOX conversion tool.
2. Load the resulting MBOX file. Support for PST and OST is on the roadmap for v1.7.
:::

## ERR-CRYPTO: encryption not available

:::warn
**Cause.** The browser has no Web Crypto or AES-256, which are needed for the encrypted forensic case file.
:::

:::howto title="Fix ERR-CRYPTO"
1. Use an up-to-date version of Chrome or Edge.
2. Make sure you open the viewer over a secure HTTPS context. Web Crypto does not work on an insecure connection.
:::

## Known browser messages that are not errors

:::info title="Blocked script execution in 'about:srcdoc'"
With DevTools open, Chrome logs this message every time an email is rendered. The preview runs inside a sandboxed iframe without `allow-scripts`, precisely to protect you from any JavaScript in mail content. Chrome prints the message for every sandboxed iframe, even for mail with no script at all. The impact is zero and users without DevTools never see it.
:::

## Frequently asked questions

:::faq
### Does my data ever leave my device when an error occurs?
No. All processing happens locally in your browser. Even on an error, nothing is uploaded.

### Where do I find the error codes in the extension?
The Support tab in Mbox Viewer lists the same codes and fixes.

### How do I report a bug that is not listed here?
Go to mbox-viewer.online for bug reports and the full FAQ, or email support. Include a short description, the steps to reproduce, and the DevTools log if you can.

### Which file formats can Mbox Viewer read?
`.mbox`, `.mbx`, `.eml`, `.emlx`, Maildir folders and compressed `.mbox.gz`. PST and OST will follow later.
:::