Data Management
Back up your data, review storage usage, mark manual nights, or remove sessions from your local history. Read the backup guide for step-by-step walkthroughs (iCloud, Google Drive, Dropbox, USB, NAS) and device-change tips.
Your CPAP data, on your terms
CPAP Clarity stores everything you import in your browser's IndexedDB. Sessions, oximeter nights, Oura data, and the settings derived from each import live on your computer, not on a server. This page gives you direct control over that local store: export everything to a single JSON file you keep, restore from that backup on a new device, mark nights you slept off-CPAP so the therapy score does not penalize them, and remove sessions you no longer want.
Atomic backup downloads a complete snapshot of every imported session, every oximeter night, every Oura night, every manual-night marker, and the most recent machine settings. The file is plain JSON; you can open it in a text editor to verify what is inside before saving. Restoring re-creates IndexedDB exactly, so a backup taken on your laptop and restored on your phone gives you the same dashboard data.
Manual nightsmark dates you slept without CPAP (illness, travel, or a chosen night off). The therapy score uses this to distinguish "user did not sleep with the machine" from "data is missing"; both look identical to a machine reading the SD card, but only the second is a therapy gap.
Frequently asked questions
What does atomic backup actually save?
A single JSON file containing every Dexie object store the site uses: imported CPAP sessions (with full session metadata and the parsed waveform-derived metrics), oximeter nights, Oura nights, manual-night markers, the most recent machine settings, and the parser version stamp on every entry. The format is documented in src/lib/backup/types.ts; you can open the file in any text editor to inspect. Restoring is the inverse: each store is replaced atomically (all-or-nothing), so a partial restore cannot corrupt your local data.
How do I restore on a new device?
On the new device, open the data hub and tap "Restore from backup" inside the Backup card. Select the JSON file you saved. Restore overwrites the current local store; if you have any sessions on the new device that are not in the backup, they will be lost. Take a fresh backup on the new device first if you want to keep them.
Will deleting a session affect my therapy score?
Yes. The therapy score is computed from the sessions present in your local store. Deleting a session removes it from the score window. Use manual-night marking to tell the score "I slept off-CPAP that night" without actually deleting any data. Sessions younger than 90 days are protected from deletion to prevent accidentally wiping recent data; the protection is documented inline where the delete buttons appear.
What happens if I clear browser data?
IndexedDB lives inside your browser's site-data store. Clearing browser data for cpapclarity.com erases everything you imported, with no recovery on our side because nothing is on our side. Take a backup before any browser cleanup, browser migration, or device swap. CPAP Clarity also requests "persistent storage" status (where supported by the browser) to reduce the chance of mid-write eviction; you can verify status under Storage in this page.
Why are some sessions undeletable?
Sessions imported in the last 90 days are protected from deletion to guard against accidental wipes of recent clinical data. The protection releases automatically on the 91st day after the session date. If you need to delete a recent session for a specific reason, use the "Clear all data" path under the Advanced accordion; that wipes everything but is at least a single deliberate gesture rather than a per-row mistake.