Skip to main content
Version: 1.x

DB01001: Connection Failed

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​

  • 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​

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​

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)​

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​

On desktop:

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

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​

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