Skip to content

Backups & Restore

RUSEON Core manages its own state (cameras, users, configurations) in an embedded BadgerDB instance located in /app/data. The video archive (/app/recordings) is managed separately.

Automated Backups

A background worker (internal backup worker) automatically generates BadgerDB .bak dumps into the /app/backups directory periodically. The worker also handles retention cleanup, automatically removing old backups to prevent disk exhaustion.

REST API Imports and Exports

You can export and import the database state in JSON format via the REST API, making it easy to migrate configurations between servers.

  • Export State (JSON):GET /api/system/backup/export
  • Import State (JSON):POST /api/system/backup/import

Restoring from a .bak file

To restore from a physical .bak file:

  1. Stop the RUSEON Core service.
  2. Move the existing /app/data folder to a safe location.
  3. Use Badger CLI or an internal recovery tool (if provided by the ruseon-cli binary) to restore the .bak file into /app/data.
  4. Start the service.

Released under the MIT License.