Settings and Storage

Settings and Storage

Settings reference

Use the UI to change settings; this table documents persisted names, not a recommendation to edit JSON.

Key	Reviewed default	Meaning
enablePermanentDelete	false	Safe Mode on; eligible ordinary folders quarantine
enableZfsDatasetDelete	true	Normalized internal ZFS capability; not an independent user bypass
quarantineRoot	Appdata share hidden quarantine directory	Fallback root when a source-specific root does not apply
defaultQuarantinePurgeDays	0	No default automatic purge; positive values up to 3650
manualAppdataSources	Empty list	Additional validated source roots
zfsPathMappings	Empty list	Share-to-physical-root associations for resolution

The default fallback is /mnt/user/<appdata-share>/.appdata-cleanup-plus-quarantine; without a detected appdata share it falls back under /mnt/user/system. Matched candidates normally quarantine under their own source root. See Quarantine and Restore.

Persistent state

Normal configuration root:

/boot/config/plugins/appdata.cleanup.plus

Relative path	Purpose
safety-settings.json	Safety, retention, sources and mappings
ignored-paths.json	Ignored candidate paths
cleanup-audit.jsonl	Local action history
quarantine-records.json	Tracked moved folders and schedules
template-backups/	Private archived Docker templates
snapshots/	Session-scoped candidate snapshots
path-stats-cache.json	Cached size/path statistics
latest-scan-metrics.json	Recorded scan telemetry

These files can contain private data. Do not upload them as a substitute for sanitized diagnostics. Preserve needed configuration and template backups before removing the plugin.

Reviewed snapshot lifetime is 30 minutes; path-statistics cache lifetime is 15 minutes. Runtime operation locks/progress are separate from durable configuration. Browser view preferences are not stored in these server files.

Installed files and scheduler

Deployed plugin root: /usr/local/emhttp/plugins/appdata.cleanup.plus/.

Scheduled purge entry: /etc/cron.d/appdata.cleanup.plus, invoking scripts/scheduled-purge.php hourly at minute 17.

The versioned package and manifest control installed code; editing deployed files manually is temporary and may be overwritten by update/reboot installation.

Developer state/runtime overrides exist for isolated tests. They are not normal production settings and must not be used to direct automated tests at a real server.