Data Management - amitsri/rostyman-releases GitHub Wiki

Data Management

All data is stored locally in a SQLite database. Nothing is sent to the cloud.

Data Location

Settings > Data > Data storage location

By default, data is stored in your system's app data folder. You can change it to:

  • iCloud Drive
  • Google Drive
  • Dropbox
  • OneDrive
  • External SSD or USB drive

The app will restart after changing the location. If the custom drive is disconnected, the app falls back to the default location.

Backup & Restore

Backup

Settings > Data > Create Backup

Exports your entire database (collections, environments, settings, history, themes, vault secrets) to a single .db file.

Restore

Settings > Data > Restore Backup

Select a previously saved backup file. The app validates it's a valid database, replaces the current data, and restarts.

Factory Reset

Settings > Data > Reset App

Permanently deletes all data and restores the app to its first-run state. Requires typing "RESET" to confirm.

Trash

Deleted items go to Trash and can be restored. All 7 entity types are trashable:

  • Collections, Folders, Requests, Environments
  • Workflows, Scheduler Jobs, Mock Servers

After deleting, a toast with Undo button appears for 6 seconds. Permanent delete from Trash requires confirmation.

Git Sync

For version-controlled backups and team sharing, use Git Sync. Export collections as .rostyman files into a Git repo, then commit, push, pull, and branch — all from the Git Sync panel.

Request History

All sent requests are automatically saved to history with full details:

  • Request: method, URL, headers, params, body (mode + language), auth config, pre/post scripts
  • Response: status code + text, headers, body, size, response time, timing breakdown (DNS/TCP/TLS/TTFB/Download)

History entries can be viewed in:

  • Sidebar > History — click to open in a new tab with full request + response restored
  • Request > History tab — per-request history with compare, filter, export, pin

Vault Security

Vault secrets are encrypted with AES-256-GCM. The encryption key is stored in your OS keychain (Windows DPAPI / macOS Keychain). See your vault key in Vault > Settings.

Vault secrets are also used by the AI Assistant — API keys for Anthropic/OpenAI are stored in the vault and resolved securely at call time.