Document configuration capture workflow

This commit is contained in:
Dandaedre 2026-10-17 10:09:47 +02:00
parent 493838a4a8
commit 1e8be079d0
2 changed files with 22 additions and 0 deletions

View File

@ -132,6 +132,8 @@ cc sync -ConfigsOnly # fetch and deploy configs; do not call WinGet
cc apply -ForceConfigs # back up local edits, then replace them
cc configs # show repository and live computer config paths
cc configs -Config helix-config # show paths for one managed config
cc capture # collect live configs under Documents for upload
cc capture -Config ontime-style # capture one config
cc restore -Config helix-config # restore the newest backup
cc doctor # inspect prerequisites and sources
cc menu # optional numbered menu
@ -174,6 +176,19 @@ the overlay with the entire application file. Use
the complete Nextcloud config because it can contain account and authentication
data.
`cc capture` automates the collection side without changing live files. By
default it creates
`Documents\ConfigCentral\captures\MACHINE-yyyyMMdd-HHmmss`. Whole-file configs
retain their `configs/` repository paths. Raw XnView, hosts, and filtered MPC-HC
exports are placed under `review/` for curation. The complete Nextcloud config is
always excluded. Use `-OutputPath PATH` to select an exact empty destination.
From CachyOS, retrieve a completed capture for review with:
```bash
scp -r USER@WINDOWS-PC:'Documents/ConfigCentral/captures/MACHINE-yyyyMMdd-HHmmss' ./
```
## Config conflicts and recovery
Config Central stores the hash it last deployed. A different destination hash,

View File

@ -9,6 +9,13 @@ does not immediately overwrite the result.
The checked-in declarations start as safe no-ops or comment-only files. Populate
only the values you want shared across every selected machine.
Run `cc capture` to collect the current machine's configuration without applying
repository content. Captures are written beneath
`Documents\ConfigCentral\captures` and split between repository-shaped
`configs/` files and raw `review/` files that require curation. Nextcloud's full
configuration is excluded. Close applications first so their files reflect the
latest saved preferences.
## MPC-HC
MPC-HC normally stores preferences below