Recording Retention
Gatwy can automatically purge old session recordings to cap disk usage. Retention is configured under Settings → Sessions.
Retention Policies
Two independent policies can be enabled together or separately:
By Age
Delete recordings older than a configurable number of days.
- Setting: Enable age-based retention → set number of days (e.g.
90) - Effect: Any recording whose session ended more than N days ago is deleted on the next purge run
By Size
Keep total recording storage under a configurable size cap (in GB). Oldest recordings are deleted first (FIFO) until the cap is met.
- Setting: Enable size-based retention → set cap in GB (e.g.
10) - Effect: If total recording storage exceeds the cap, the oldest recordings are deleted until storage is back under the limit
When Purges Run
The auto-purge job runs:
- On container startup
- Every 6 hours while the container is running
Manual Purge
To immediately delete all session history and recordings, go to Settings → Sessions → Purge All Sessions. This is a destructive action and cannot be undone.
Purged recordings cannot be recovered unless you have a backup that includes recordings. See Backup & Restore.
Storage Location
All recordings are stored in:
/app/data/recordings/
You can monitor current disk usage under Settings → Sessions → Storage Used.