Skip to main content
Because getbased stores your working data locally in your browser by default, there is no account-backed cloud backup automatically safeguarding your health records. getbased gives you three independent backup layers to keep your data safe: automatic in-browser snapshots, automatic folder backups to any location you choose, and on-demand JSON exports.

Automatic in-browser snapshots

getbased automatically creates snapshots of your data in the background as you make changes:
  • A snapshot is triggered 5 minutes after a data change (debounced — rapid changes create only one snapshot, not many).
  • Up to 5 snapshots are stored. When a new one is added, the oldest is pruned.
  • Each snapshot includes stored profile data, including lab entries, reviewed meals and small thumbnails, nutrition targets, marker category placements, context cards, notes, supplements, cycle data, conversations, custom personas, per-profile preferences, and device-local AI model-test history.
Snapshots are stored in IndexedDB and never leave your browser. They are not affected by clearing localStorage.

Restore from a snapshot

1

Open backup settings

Go to Settings → Data → Backup & Restore.
2

Choose a snapshot

Each entry shows the date and time it was created. Find the snapshot you want to restore.
3

Restore

Click Restore next to that snapshot. getbased rolls your data back to that point immediately.
You can restore a snapshot even without a passphrase configured — snapshots follow the same encryption state as your data at the time they were created.

Automatic folder backup

Folder backup automatically saves your data to a folder on your computer — your local drive, Proton Drive, Dropbox, a NAS, or anywhere you choose. This uses the browser’s File System Access API.
Folder backup requires Chrome, Chromium 86+, Edge 86+, or Opera 72+. Firefox and Safari do not support the File System Access API. Use JSON export on those browsers.

Set up folder backup

The fastest path is the dashboard’s Protect your data pill, which opens a picker that includes Auto-backup. Or:
1

Open backup settings

Go to Settings → Data → Folder Backup.
2

Pick a destination folder

Click Pick Folder and select where you want backups saved. This can be a local folder, a Proton Drive sync folder, a Dropbox folder, or any path your OS can write to.
3

Done

Backups run automatically from now on. The folder handle is remembered across browser sessions — you only need to pick the folder once.

What gets saved

Each folder backup is a full snapshot of your getbased database:
  • All profiles and their lab entries
  • Context cards, notes, supplements, cycle data
  • Reviewed meal records, nutrition targets, and small meal thumbnails; full-size meal photos are never saved
  • Chat history and conversation threads
  • Custom personalities and marker definitions
  • Per-profile marker category placements and display customizations
  • App settings. Supported credentials are included only when passphrase protection is enabled, and remain passphrase-encrypted.
  • Device-local AI model-test history
  • Eligible wearable IndexedDB rows. OAuth tokens and always-device-encrypted WHOOP and Google Health raw rows are excluded; other device-local daily rows follow the active passphrase state.
Unsent per-conversation chat drafts stay only in the working browser and are not included in snapshots, folder backups, or manual exports. Sent messages, conversation project names/membership, and custom personas are included. Original chat image files, downloaded voice models, and an installed Companion or agent login are not portable chat backup contents; reconnect local agents on each computer. With passphrase protection off, browser-device d1: credential envelopes are omitted because their non-exportable key cannot move to another browser. With protection on, supported credentials can be restored only with the same passphrase and included encryption salt. Wearable OAuth tokens are never backed up, so reconnect providers after moving browsers. Two files are written to your chosen folder on each backup:
  • getbased-backup-latest.json — always-current snapshot, overwritten on each run
  • getbased-backup-YYYY-MM-DD.json — daily dated snapshot, retained for up to 30 days

When backups run

A folder backup is triggered automatically 5 minutes after data changes. You can also trigger a manual backup from the Settings panel at any time.

Restore from a folder backup

Folder backup files are standard getbased JSON exports. Restore one the same way you import any JSON file:
1

Locate your backup file

Find the getbased-backup-latest.json or any dated backup file in your backup folder.
2

Open getbased

Open getbased in any Chromium-based browser (or Firefox/Safari if restoring a single-profile export).
3

Import the file

Drop the .json file onto the app or select it with the header import button. getbased detects it automatically and merges it into your current data.
For full database bundles that contain multiple profiles, getbased handles profile merging automatically — new profiles are created and existing ones are merged.

Restore a backup before rejoining Sync

When a full backup is restored, getbased marks every restored profile for recovery. If you then join an existing Sync identity, it publishes those profiles before accepting remote tombstones or older relay state. This protects restored history—including supplement and medication periods—from briefly appearing and then disappearing after the first pull. Keep the tab open until Sync reports that it has finished, then verify the restored profiles on another connected device. A backup is still the recovery source of last resort: the relay is an encrypted synchronization service, not a substitute for independent backups.

Backup reminder

If you have not configured folder backup and have not manually exported in over 30 days, getbased shows a gentle reminder. You can snooze it for 30 days or set up folder backup to dismiss it permanently.

Manual JSON export as a backup strategy

In addition to automatic backups, you can download a plaintext JSON copy of your data at any time from Settings → Data → Export. This is your most portable backup — it is a plain file you can store anywhere: a password manager, an encrypted USB drive, or an offline backup. An Export All database bundle contains each profile’s complete stored data, including local AI model-test records. A curated single-profile JSON export does not include model-test diagnostics, and its compatibility import path does not restore every structured supplement/medication product and quality field. Model-test history is also excluded from cross-device sync, so use a full database or folder backup when you want a full-fidelity restore. See Export and import your data for the full export and import workflow.