# DB01001: Connection Failed

## What This Means[​](#what-this-means "Direct link to What This Means")

The POS could not connect to its local database. WCPOS uses a local database to store products, customers, and other data for fast access and offline functionality.

## Common Causes[​](#common-causes "Direct link to Common Causes")

* **Storage full** — Device has no storage space left
* **Database corrupted** — Local database files are damaged
* **Permission issue** — App doesn't have storage permissions
* **Browser storage disabled** — IndexedDB is disabled (web version)

## How to Fix[​](#how-to-fix "Direct link to How to Fix")

### 1. Check Storage Space[​](#1-check-storage-space "Direct link to 1. Check Storage Space")

Ensure your device has available storage:

* Free up space if storage is full
* Delete unused apps or files
* Check available disk space

### 2. Clear App Data[​](#2-clear-app-data "Direct link to 2. Clear App Data")

Check for unsaved work first

Clearing local data or reinstalling the app deletes anything on this device that hasn't reached your store — including sales taken while offline, open carts, and edits that didn't save. Before you clear anything, open **Store health → Database** and check nothing is listed as held or as never having reached your server, then **Store health → Logs** for **0 stuck records** and **0 changes waiting to send**; then finish or note every open cart. If your WCPOS has no Store health page, update WCPOS first, then check. If anything is listed or waiting, or you can't check, don't clear — ask your store owner or contact support.

Only if steps 1, 3 and 4 didn't help, and only after the check above, reset the local database:

* **Desktop app:** Look for "Clear Data" in settings
* **Web browser:** Clear site data for the POS domain
* **Note:** data already on your store downloads again; anything that never reached your store is gone

### 3. Check Browser Settings (Web)[​](#3-check-browser-settings-web "Direct link to 3. Check Browser Settings (Web)")

If using the web version:

1. Ensure IndexedDB is enabled
2. Don't use private/incognito mode (limited storage)
3. Allow the site to store data

### 4. Check Permissions[​](#4-check-permissions "Direct link to 4. Check Permissions")

On desktop:

* Ensure the app has permission to write to its data directory
* Check if antivirus is blocking database access

### 5. Reinstall the App[​](#5-reinstall-the-app "Direct link to 5. Reinstall the App")

Check for unsaved work first

Clearing local data or reinstalling the app deletes anything on this device that hasn't reached your store — including sales taken while offline, open carts, and edits that didn't save. Before you clear anything, open **Store health → Database** and check nothing is listed as held or as never having reached your server, then **Store health → Logs** for **0 stuck records** and **0 changes waiting to send**; then finish or note every open cart. If your WCPOS has no Store health page, update WCPOS first, then check. If anything is listed or waiting, or you can't check, don't clear — ask your store owner or contact support.

Only if other solutions fail, and only after the check above:

1. Uninstall the POS app
2. Restart your device
3. Reinstall the app
4. Login and sync data

## Data Recovery[​](#data-recovery "Direct link to Data Recovery")

If you have unsaved data:

* The app may have pending changes that couldn't be synced
* Contact support if you need help recovering data
* Data already on your store downloads again after a clear, but sales that never reached your store exist only on this device — clearing or reinstalling deletes them, so contact support before either

## Related Errors[​](#related-errors "Direct link to Related Errors")

* [DB01002](/error-codes/DB01002.md) — Query Timeout
* [SY01002](/error-codes/SY01002.md) — Disk Full
