Central config manager
Go to file
Dandaedre 40039a4171
Config Central CI Config Central passed all CI integrity checks.
Beffroi/config-central/pipeline/head This commit looks good Details
Simplify setup and config update documentation
2026-10-17 11:26:52 +02:00
configs Import safe Nextcloud preferences 2026-10-17 10:25:05 +02:00
docs Simplify setup and config update documentation 2026-10-17 11:26:52 +02:00
machines Add requested desktop application packages 2026-10-16 14:25:36 +02:00
profiles Add Shotcut to desktop packages 2026-10-16 17:04:12 +02:00
schemas Add application configuration adapters 2026-10-16 14:29:15 +02:00
src Capture allowlisted Nextcloud preferences 2026-10-17 10:25:43 +02:00
tests Add one-command web config updates 2026-10-17 11:25:55 +02:00
tools Add fast temporary SSH installation path 2026-10-17 10:12:30 +02:00
AGENTS.md Add one-stop web installer 2026-10-17 09:03:09 +02:00
Jenkinsfile Add one-stop web installer 2026-10-17 09:03:09 +02:00
README.md Simplify setup and config update documentation 2026-10-17 11:26:52 +02:00
TASKS.md Simplify setup and config update documentation 2026-10-17 11:26:52 +02:00
bootstrap.ps1 Resolve freshly installed bootstrap tools 2026-10-17 09:56:46 +02:00
cc.cmd
…
cc.ps1 Add safe configuration capture command 2026-10-17 10:09:32 +02:00
install.ps1 Add one-command web config updates 2026-10-17 11:25:55 +02:00
update-configs.ps1 Add one-command web config updates 2026-10-17 11:25:55 +02:00

README.md

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.

1. Set up the computer once

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

Setup selects the matching machine profile or asks you to choose one. It installs Git, PowerShell 7, and the declared software, then applies the configs. Approve administrator prompts when needed. Rerun this command to repair setup.

Requires Windows 10 1809 or newer, Windows 11, or Windows Server 2025, with internet access and support for WinGet.

2. Update configs whenever needed

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. No menu, manual Git pull, or software installation. Temporary downloads are removed afterward.

Unchanged configs are skipped and replacements are backed up. Local edits are reported as conflicts instead of being silently lost; see replacing local edits. 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. 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.