Skip to main content

Usage

Backup & Restore - ONA.UNO Docs

Create backups of your ONA.UNO state and restore them later.

What Backup & Restore is

Backup & Restore creates a snapshot of ONA.UNO’s current state so you can return to it later.

This is useful before:

  • making major settings changes
  • importing a lot of data
  • troubleshooting issues

Where to find it

Go to:

Settings → Maintenance → Backup & Restore

What’s included

Backups are designed to capture ONA.UNO’s app state, including:

  • your ONA.UNO database (sources.db) and the items inside it
  • AI-generated metadata (summaries, titles, tags, embeddings)
  • your app settings (including per‑Set settings)
  • credentials payload (keychain.json) used during restore:
    • Feedbin credentials
    • (optional) your OpenRouter API key, only if you enable Include OpenRouter API key in backups

OpenRouter and Feedbin credentials are stored locally in macOS Keychain during normal app use. Backup inclusion of the OpenRouter key remains opt-in.

What’s not included (by design)

  • Your original files for Folder and Obsidian sources (ONA.UNO reads those from disk)
  • Downloaded local AI model files (Mixed mode models)
  • macOS permissions (you may need to re‑grant access to folders after restoring)

Restore behavior (important)

Restoring a backup requires ONA.UNO to restart:

  1. You choose a backup to restore.
  2. ONA.UNO creates a safety backup of your current state first.
  3. ONA.UNO quits and applies the restore on the next launch.

OpenRouter key safety during restore:

  • If you choose to preserve your existing OpenRouter key (or the backup does not include one), ONA.UNO keeps your current key.
  • If you include and restore an OpenRouter key from backup, that backup key becomes the active key.

Automatic backup before AI tag consolidation

When you run AI → Consolidate AI Tags… and confirm apply, ONA.UNO creates an automatic backup first.

  • Backup kind: tagConsolidation
  • Backup note: Automatic backup before tag consolidation

This gives you a rollback point before any AI-tag replacements are written.

Browser Clips safety and recovery

Browser Clips are special because they are ingested into ONA.UNO (there isn’t a separate “source file” you manage yourself).

ONA.UNO therefore provides two layers of safety:

  • Backups (this page)
  • A Browser Clips export/import feature (portable Markdown) and a built‑in recovery sync after restores

If you want a portable copy of your clipped pages, see Save Webpages You Visit.

Related / Next