System Sync & Restore (ssr) - Wiki

Reproducible macOS setup: snapshot Homebrew + app configs to your cloud drive, restore on a new machine with one workflow.

Repository: System-Sync-Restore | Issues & PRs: use the main repo, not this wiki clone.

Documentation map

Topic	Page
Requirements, install, first steps	Quick-start
CLI commands	Commands
Cloud layout, Mackup, unmanaged apps, macOS pref snapshots	Backup-structure-and-sync
`ssr.conf` keys and cloud providers	Configuration-reference
launchd schedule, logs, `ssr update`	Scheduling-logging-and-updates
zsh / bash / fish completions	Shell-completions
Security model, uninstall, legacy script migration	Security-Uninstall-and-Migration
Repo directories and scripts	Repository-layout

Backup: ssr sync - Brewfile + Mackup copy to cloud (no symlinks by default).
Restore: ssr restore - Homebrew, Brewfile, Mackup, macOS defaults + pref snapshots.
Schedule: ssr schedule on - daily launchd agent (configurable hour).
No secrets in git: state lives on your cloud drive; repo is code + templates only.

Successor to system_sync.sh / system_restore.sh: same intent, modular and idempotent tooling.