Database housekeeping, scheduled unlinked-file cleanup, and one-off tools.
| Setting |
What it does |
Vacuum on startup
db.is-startup-vacuum-enabled |
Reclaim SQLite space; may slow start. Default off. |
SAB history retention
database.history-retention-days |
Days of SAB history to keep. Does not delete WebDAV files; 0 = keep all. Default 90. |
Health-check retention
database.healthcheck-retention-days |
Days of health-check results to keep; 0 = keep all. Default 30. |
Raw fetch-event retention since 1.1.0
metrics.fetch-retention-hours |
Hours (0–8760) of raw SegmentFetches / FailoverMisses rows; rollups kept; 0 = rollup-only (one-hour floor). Default 24. |
Enable daily cleanup
maintenance.remove-orphaned-schedule-enabled |
Runs Remove Orphaned Files once a day. Default off. |
Daily run time
maintenance.remove-orphaned-schedule-time |
Minutes from midnight; uses container TZ. Default midnight (0). |
| Task |
What it does |
| Clean Missing Payloads since 1.3.0 |
Remove mounts whose payload blob and legacy metadata are both absent, and request Arr replacements. Caution: Permanent; dry run and /config backup required; never blocklists the release. |
| Remove Orphaned Files |
Remove unlinked WebDAV files (not linked from the library). Caution: Permanent; dry run available. If more than 90% appear unlinked, review the audit and use its 15-minute approval. Library Directory must be the organized library, not the rclone mount. |
| Prune Completed History |
Remove completed SAB history rows. Caution: History-only; mounts stay; unlinked mounts become eligible for Remove Orphaned Files. |
| Rename Windows-Invalid Paths |
Sanitize existing names. Caution: Needs Windows-safe paths; backup + dry run. |
| Convert STRM Files to Symlinks |
Strategy migration. Caution: Needs library dir + rclone mount. |
| Recreate STRM Files |
Refresh sidecars. Caution: Needs STRM strategy + completed dir + base URL. |
| Migrate Large Database Blobs to Blobstore |
Background optimization. Caution: Usually automatic. |
| Re-run Library Health Checks since 1.3.0 |
Fresh health-check pass over every video, audio, and archive file, including items still in SAB history. Caution: Heavy Usenet STAT traffic on large libraries; runs in the background. |
| Reset Health-Check Statistics |
Clear health-check history. Caution: Cannot undo. |
| Reset Overview Statistics since 0.8.0 |
Clear overview metrics. Caution: Cannot undo. |
Retention · Deletion audit
