Data, backup, and moving machines
Where projects and scans live on disk, the scan retention setting, exporting a database backup, moving to a new machine, and what deleting a project removes.
Updated
Everything GeckoGrid stores lives in one SQLite database file on your machine. Nothing is synced to a cloud service, so backup and migration are file operations you control.
Where your projects and scans live
The database file is geckogrid.db inside the app data folder. Settings > Application shows the exact path on your machine, which is the authoritative answer. The default locations:
- Windows:
C:\Users\<you>\AppData\Roaming\com.geckogrid.desktop\ - macOS:
~/Library/Application Support/com.geckogrid.desktop/ - Linux:
~/.local/share/com.geckogrid.desktop/
Uninstalling the app leaves this folder alone, so removing GeckoGrid without losing history means deleting the folder by hand afterwards.
Keeping history small
The scan retention setting in Settings > Results, Keep last N scans per keyword, prunes older history automatically after each scan. Set it between 1 and 100, or leave it at 0 to keep everything, the default. Nothing is deleted unless you opt in.
Exporting a backup
Settings > Application has an Export Database Backup button. It writes a consistent, timestamped copy of the database, named like geckogrid_backup_20261104_101500.db, to your Downloads folder. Take one before updating to a new version or whenever you want a snapshot.
Moving to a new machine
- On the old machine, export a backup as above.
- Install and launch GeckoGrid on the new machine and activate your key.
- On the old machine, open Settings > License and click Deactivate This Machine to free its seat.
- Restore your history on the new machine: quit GeckoGrid, then place the backup file into the new machine’s app data folder and rename it to
geckogrid.db, replacing the fresh one. There is no in-app restore button; the backup is a standard SQLite database file. Launch GeckoGrid and your projects and scans are there.
What deleting a project removes
Deleting a project deletes its scans and its reports with it. The delete is refused while any of the project’s scans is running or queued, with a message telling you to cancel the active scan first, and while one of its reports is still collecting. Cancel or let those finish, then delete; there is no undo, so export anything you want to keep first, and the exporting results page covers image and CSV exports.
Was this helpful?