Backup & Restore
Export and import your RawMon data: JSON backup format, what's included, cross-device transfer, and version compatibility.
Overview
RawMon stores all data locally on your device. The backup feature lets you export everything to a JSON file for safekeeping or transfer to another device.
Backup Format
Backups use JSON format with a version identifier. The current version is V9. Each backup file contains the version number and all exportable data.
What's Included
| Data | Description |
|---|---|
| Monitors | All native monitors with their configuration (URL, type, interval, thresholds) |
| Provider connections | API keys and URLs for all connected SaaS providers |
| Incidents | Full incident history with timelines and notes |
| Credentials | Stored authentication details (encrypted via SecureStore on device) |
| Groups | Monitor group definitions and sort order |
| HMAC secrets | Signing keys for heartbeat/script monitors |
| Certificate thresholds | Multi-threshold warning configurations per monitor |
| Device ID | Your stable push notification device identifier |
| Settings | App preferences (check intervals, notification settings, geofencing profiles) |
What's NOT Included
- Heartbeat history (raw check results) — too large for practical export
- Cached SaaS provider data — re-synced automatically after restore
- App lock / biometric settings — device-specific, not transferable
Creating a Backup
- Go to Settings > Backup & Restore > Export Backup.
- RawMon generates a JSON file with all your data.
- Choose where to save it: Files app, iCloud Drive, Google Drive, or share via AirDrop/email.
The backup file is named rawmon-backup-YYYY-MM-DD.json by default.
Restoring a Backup
- Go to Settings > Backup & Restore > Import Backup.
- Select your backup JSON file.
- RawMon validates the file format and version.
- Review the summary and confirm the restore.
- The app restarts with the restored data.
Free Plan Limits on Restore
Backup and restore is free for all users. When restoring on a free plan, all data is imported — but monitors and providers beyond the free plan limits are automatically paused:
- First 5 monitors remain active, the rest are paused.
- First data source remains connected, extra sources are deactivated.
- Your device ID is always restored (push notification webhooks keep working).
You'll see a prompt to upgrade to Pro to activate all imported monitors. No data is lost — paused monitors can be activated individually or by upgrading.
Cross-Device Transfer
To move your monitoring setup to a new phone:
- Export a backup on your old device.
- Transfer the JSON file (AirDrop, cloud storage, email).
- Install RawMon on the new device.
- Import the backup.
Your device ID is preserved in the backup, so push notifications continue to work after transfer. Provider connections re-sync automatically. If you exceed the free plan limits, excess monitors are paused (see above).
Version Compatibility
Backups are forward-compatible. A V9 backup can be imported into any future version of RawMon — the app handles migration of older backup formats automatically. Importing a backup from a newer app version into an older app version is not supported.
Best Practices
- Schedule regular backups before app updates or OS upgrades.
- Store backups in cloud storage (iCloud, Google Drive) for redundancy.
- Test your backup by importing it on a second device or after a fresh install.
- Do not manually edit the JSON file — invalid structure will cause import to fail.