Your data

Where it is kept

Collections, environments, settings and history are kept in one SQLite file in Porticol's data folder on your computer. Settings > Data shows the folder, with a button to open it in your file manager.

Secret values are kept apart from that file, in your operating system's keychain. On Linux without a keychain service, Porticol says so when it starts and keeps them in a file encrypted under a passphrase you set, which it asks for once each launch. Settings > Data shows that file. Once it holds secrets, Porticol keeps using it. A forgotten passphrase can't be recovered: moving the file aside starts again without those values.

Before an update changes the database, Porticol copies it beside the original. If the change fails, nothing is written, and Porticol says where the copy is.

Back up and restore

Settings > Data > Backup saves one file with your collections, environments, globals and settings. Secret values and credentials typed into requests are left out, but plain variables and scripts are written as they are, so keep the file private. Tick Include cookies to add the cookie jar; cookies marked HttpOnly are never included.

Restore replaces the collections, environments, globals and settings on this computer with a backup's, and the cookies if it has them. It asks first. History and certificates stay as they were. Secret values this computer already holds for the same environment are kept, and Porticol lists the secrets that came back without a value.

Crash and usage reports

Settings > Privacy has two switches, each off until you turn it on:

A report never holds requests, responses, URLs, headers, variables or file paths. The preview shows the reports waiting on this computer exactly as they would be sent, with the installation ID that goes with them: a random value that names no person or machine. If Porticol stops working while crash reports are off, the next launch offers to send that one report, once.

Your organisation can hold either switch on or off; see Managed deployment.