Backup & Restore

Download a portable snapshot of all control-plane persisted state, including settings and SQLite vector databases.

Backups contain credentials, device tokens, Data Protection keys, chat and memory records, artifacts, and vector embeddings. Store the ZIP securely. The full restore replaces persisted files and takes effect on the next application restart.

Full backup

Includes persistent application and agent settings, endpoints, MCP configuration, models, workflows, UI preferences, token records, chats, memory stores, shared and per-store vector databases, artifact files, and persistent runtime data.

SQLite databases use consistent online snapshots, including when the application is running. A large vector database or artifact store can make the download sizable.

Restore full backup

Import a backup ZIP made by this page. Every listed file and its SHA-256 checksum is verified before a restore is scheduled.

Restoration is staged first to avoid overwriting open SQLite databases. Once validated, restart the application: the restored settings, vectors, and data will be installed before services initialize. Do not keep writing new data between staging and restart.

The import never executes archive scripts and cannot write to arbitrary paths. It restores only the application's configured persistent storage roots. A full restore may replace current configuration, Data Protection keys, and vector collections.