5.2 KiB
Config Central
Install the software and settings for a Windows desktop, then keep its configs up to date with one command. No management server or background agent is needed.
The workflows below separate initial setup, software updates, and routine config updates. This keeps each operation explicit and makes its effects easy to review.
1. Install software and apply configs
Open Windows PowerShell as your normal desktop user and paste:
irm 'https://proxy.dandaedre.com/gitea/Beffroi/config-central/raw/branch/main/install.ps1' | iex
The bundled machine profile is beffroi-laptop, selected automatically. If you
add more machines, setup matches the computer name or asks you to choose one. It
installs Git, PowerShell 7, and the declared software, then applies the configs.
Approve administrator prompts when needed. Existing managed settings are backed
up and replaced with repository versions. Run this command on a new computer,
when you add software to the install list, or when you need to repair setup.
Requires Windows 10 1809 or newer, Windows 11, or Windows Server 2025, with internet access and support for WinGet.
2. Update installed software
Close applications that may be updated, open PowerShell as your normal desktop user, and run:
cc update-software
This command updates software selected by the current machine manifest without deploying any configs. It runs operations sequentially in this order:
- Resolve and apply opted-in portable packages. Config Central selects the newest release allowed by the package's channel, downloads its exact Windows asset, verifies it against the release's published SHA-256 checksum, stages it in a new version directory, and switches to it only after setup succeeds.
- Install or upgrade every declared WinGet package by exact ID and source,
according to its
latest,pinned, orinstall-onlypolicy. Applications not declared in Config Central are left alone; the command does not run an unrestrictedwinget upgrade --all.
Machine-scope WinGet operations may request administrator approval. Config Central preserves installer diagnostics, continues independent packages after an item failure, reports reboot requirements, and never restarts Windows. Close a running portable application before updating it; previous versions are kept so a failed activation does not remove the working copy.
PDF Presenter is the first portable release package. The desktop profile follows
its preview channel, verifies SHA256SUMS, and creates a Start menu shortcut at
Start → Config Central → idle-org that launches pdf-presenter.exe directly
with its embedded icon.
update-software uses the current repository checkout and does not fetch new
Config Central policy. Run cc sync first when the repository itself has changed.
For the release declaration and manual pin-review workflow, see
portable package updates.
3. Update configs without touching software
Close the applications whose settings you are updating, then paste into PowerShell:
irm 'https://proxy.dandaedre.com/gitea/Beffroi/config-central/raw/branch/main/update-configs.ps1' | iex
This downloads the latest configs and updater code from your saved repository branch and applies them to your saved machine profile, using the same config deployment as install. It skips prerequisite setup and software installation or upgrades. No menu or manual Git pull is needed; temporary downloads are removed afterward. Run install once before using update on a new computer.
Unchanged configs are skipped. Local settings are backed up and replaced with the repository versions by default. To preserve local edits instead, see advanced update options. Windows may request administrator approval for settings such as the hosts file.
Collect settings from a computer
After changing settings in an application, close it and run in a new terminal:
cc capture
The files are saved under
Documents\ConfigCentral\captures\MACHINE-yyyyMMdd-HHmmss.
Review them, copy the desired settings into this repository, then commit and
push. Run the update command on the other computers to receive those changes.
This includes Windows sound-event settings and the active power plan's battery
screen timeout. The repository defaults disable system sounds and keep the
screen on while on battery.
Capture does not upload anything automatically; some exports need curation. See the application config guide for details.
Troubleshooting and advanced use
Run cc doctor in a new terminal to check setup, or cc status to inspect the
last run and config drift. Status colors highlight failures (red), conflicts or
skips (yellow), completed work (green), and unchanged items (gray).
- Advanced commands: profiles, packages, conflicts, backups, schedules, and development checks.
- Remote access from CachyOS: temporary debugging shells and permanent SSH access.
- Application configs: MPC-HC, Ontime, XnView MP, Nextcloud, and hosts.