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.