Skip to main content

Data Backup & Restore

Kognar Platform stores all your conversations, folders, and settings locally on your device. You can export a backup at any time to keep your data safe or transfer it to another machine.

Exporting a backup​

  1. Open Settings (Ctrl/Cmd+U)
  2. Go to General > Data & Storage
  3. Click Export backup

A compressed backup file is saved to your Downloads folder:

kognar-backup-YYYY-MM-DD.msgpack.gz

The backup includes:

  • All conversations and their messages
  • Folder names and per-folder instructions
  • Conversation-to-folder assignments
  • Rendered component data (charts, tables, etc.)

Importing a backup​

  1. Open Settings > General > Data & Storage
  2. Click Import backup
  3. Select a .msgpack.gz file (or a legacy .json backup if migrating from an older version)
  4. Confirm the import
warning

Importing overwrites your current folder data and conversation assignments. Existing conversations are not deleted — they are merged with the imported data.

Resetting the app​

If you want to wipe everything and start fresh:

  1. Open Settings > General > Data & Storage
  2. Click Reset application
  3. Read the warning and confirm
danger

Reset is permanent and irreversible. It deletes:

  • All conversation history and messages
  • All settings and preferences
  • All folders and folder instructions
  • All custom agents and rules
  • All local cache and index data

There is no undo. Export a backup first if you might need your data later.

Clearing the cache​

The search index and UI cache can become stale in rare cases. To rebuild them:

  1. Open Settings > General > Data & Storage
  2. Click Clear cache

This only removes temporary index data — no conversations or settings are affected.

Storage location​

Kognar stores data locally on your device using a SQLite database and an Electron settings file. The exact location depends on your operating system:

PlatformLocation
macOS~/Library/Application Support/kognar-chat-client/
Windows%APPDATA%\kognar-chat-client\
Linux~/.config/kognar-chat-client/