# wp-stage-sync

> A Go CLI and TUI that syncs a live WordPress site to its staging site on the same Linux server: database copy with WooCommerce order filtering and anonymisation, wp-content rsync, WP-CLI URL replacement, and cache and CDN cleanup on staging. It never writes to the live database. Promote mode copies selected themes and plugins from staging to live after a backup.

Install: curl -sSL https://ada.tools/wp-stage-sync/install.sh | bash

## Docs

- [Getting started](https://ada.tools/wp-stage-sync/docs/getting-started/): wp-stage-sync copies a live WordPress site to its staging site on the same Linux server.
- [The interactive app](https://ada.tools/wp-stage-sync/docs/interactive/): Run wp-stage-sync with no arguments to open the interactive app, a full-screen terminal wizard that sets up a site pair and runs a sync.
- [Unattended runs](https://ada.tools/wp-stage-sync/docs/unattended/): The -u flag runs a sync without the interactive app, from a site configuration saved earlier, so it fits cron jobs and scripts.
- [Configuration](https://ada.tools/wp-stage-sync/docs/configuration/): wp-stage-sync keeps one config.json per site pair and one global settings.json, both under ~/.config/wp-stage-sync/.
- [How a sync works](https://ada.tools/wp-stage-sync/docs/how-it-works/): A sync runs a fixed list of steps, the same in the TUI and in unattended mode: checks that change nothing, then the database, then the files, then WP-CLI on the staging site.
- [Cache plugins](https://ada.tools/wp-stage-sync/docs/cache-plugins/): The import copies live's plugin settings to the staging site, including CDN, Cloudflare and firewall credentials, and the file sync copies config files that hold live's paths.
- [Object cache](https://ada.tools/wp-stage-sync/docs/object-cache/): A persistent object cache drop-in (wp-content/object-cache.php) is copied to the staging site with the other files, so staging connects to the same Redis or Memcached server as live.
- [Servers](https://ada.tools/wp-stage-sync/docs/servers/): The interactive app lists the WordPress sites on the server by reading the web server configs, then the file system, and pairs each live site with its staging site by folder name.
- [Promote and restore](https://ada.tools/wp-stage-sync/docs/promote-and-restore/): Promote copies selected themes, plugins and must-use plugins from the staging site to the live site, after it backs up the live copies.
- [Safety](https://ada.tools/wp-stage-sync/docs/safety/): The default sync reads the live site and writes only to the staging site.
- [Troubleshooting](https://ada.tools/wp-stage-sync/docs/troubleshooting/): This page lists the errors and warnings a sync can print, grouped by the step that prints them, with the reason and the fix.