config-central/README.md

86 lines
3.9 KiB
Markdown

# 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.
Both commands below apply the latest repository configs. **Install** also sets
up the tools and installs or updates the declared software. **Update** does only
the configs, making it the faster choice for everyday changes after setup.
## 1. Install software and apply configs
Open **Windows PowerShell** as your normal desktop user and paste:
```powershell
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.
The desktop profile also installs PDF Presenter as a verified portable package
on Windows x64, pinned to preview version 0.1.33. Launch `pdf-presenter` from
Start → Config Central → idle-org. Close it before running install or `cc sync`
to update software; the config-only update below skips it. Future PDF Presenter
updates require a reviewed version/checksum change in the profile. See
[portable package updates](docs/advanced_commands.md#portable-package-updates).
## 2. Use update for routine config changes
Close the applications whose settings you are updating, then paste into
**PowerShell**:
```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](docs/advanced_commands.md#web-config-updater).
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:
```powershell
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](docs/desktop-app-configs.md) 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](docs/advanced_commands.md): profiles, packages, conflicts,
backups, schedules, and development checks.
- [Remote access from CachyOS](docs/advanced-remote-access.md): temporary debugging
shells and permanent SSH access.
- [Application configs](docs/desktop-app-configs.md): MPC-HC, Ontime, XnView MP,
Nextcloud, and hosts.