Configuration overview
Docs/dominion-protect/Configuration overview

Configuration overview

Understand database, recording, subscription, query, rollback, and cleanup settings.

File location

plugins/DominionProtect/config.yml

The plugin generates this file on startup. After changes, run:

/domp admin reload

For database, table-structure, or dependency changes, schedule a restart and check the startup log.

Configuration groups

GroupResponsibilityImportant keys
language / debugLanguage and diagnosticslanguage, debug
databasePool, storage optimization, compression, and index observationpoolSize, optimizeStorageOnStartup
recordingDual-buffer flushing, batch writes, and action allowlistsflushIntervalSeconds, batchSize
subscriptionVault fallback, default plan, and plan listvaultUnavailableStrategy, plans
queryInspect time range and page sizeinspectDefaultTime, pageSize
rollbackLimits, preview, confirmation, and execution pacingmaxRecords, previewMaxBlocks
cleanupGrace period, retention, failed files, and reclamationgracePeriodDays, maxRetentionDays

Editing principles

  • Back up config.yml and do not change version.
  • Lowering recording.batchSize or shortening the flush interval changes database pressure.
  • A non-empty enabledActions list activates allowlist mode; disabledActions takes precedence.
  • rollback.maxRecords is a safety limit; do not raise it simply for convenience.
  • Keep optional index drops disabled until the observation period proves the index unused.
  • When generated files, docs, and logs disagree, follow the generated file and the installed build.