peardata/user-guide/settings.md

Settings

Settings persist under ~/.config/peardata (or PEARDATA_HOME) for desktop prefs. Agent storage policy is stored on the agent itself.

Appearance

Setting	Notes
Theme	Light / dark
Accent / density / motion	Visual prefs for the desktop shell

Charts / Overview

Setting	Notes
Overview spark depth	Sample count when Charts has no overriding window
Default spotlight chart	Chart id for Overview explore (e.g. system.io)

Data Manager

Controls agent-side history so disks and RAM stay bounded. Requires an admin connection to the agent.

Control	What it does
Usage cards	Total data dir size, Corestore size, in-memory hot/warm points, warm HyperDB sample
Hot memory	1s ring depth (15m → 24h presets or custom points)
Warm memory	Downsampled in-RAM ring + samples-per-bucket
Disk history	Auto-rotate by age (default 3 months; also 1 day → forever, or custom days)
Soft disk budget	Corestore size target that triggers extra prune (default 1 GiB; 0 / Unlimited = none)
Max warm points	Hard cap on stored warm samples (0 = unlimited)
Auto prune	Scheduled prune interval (hours; default on) — also runs physical GC
Dry-run / Prune now	Preview deletes or prune + reclaim disk (clearUnlinked + compact)
Save to agent	Applies live + writes retention.json on the agent

Default warm retention preset is 3 months with a soft 1 GiB corestore budget. Prune deletes expired warm points then runs Hyperbee clearUnlinked + Hypercore compact so disk is actually reclaimed. Env seeds (PEARDATA_TIER*, PEARDATA_WARM_*) only apply when no retention.json exists yet. See CONFIGURATION.md and STORAGE-HYPERDB.md.

Connections

Setting	Notes
Restore saved agents	Auto-dial peers on launch
Max reconnect attempts	Cap for background dial retries

Notifications

Desktop notification toggles for alerts (when the runtime supports them).

Reset

Clearing local desktop prefs does not delete agent data. Use Data → Prune now or tighten retention to reclaim warm history on the agent.