config-central/README.md

65 lines
2.5 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.
## 1. Set up the computer once
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
```
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**:
```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](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.
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.
- [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.