Troubleshooting

Sync failed

What a sync collects and how often it runs, what happens when it fails, how the dashboard retries and marks a site offline, and what to check.

Applies to: All plans

A sync reads a site's WordPress and PHP versions, available core updates, plugins and themes, administrators, the checksums of wp-config.php and .htaccess, and its security snapshot. Paid plans sync every 6 hours and the free plan every 24 hours; the plugin also sends an update once a day.

Pushes from the site

Once a day, and when you click Sync Now in the plugin, the site pushes its own state to the dashboard. A push updates plugins, themes and administrators and appears on the Sync Logs tab as Pushed by site; the dashboard's own reads appear as Dashboard.

The PHP and WordPress versions, though, come from the dashboard's own read of the site. A push runs from WP-cron, under whatever PHP the server's cron uses, and that can be an older binary than the one serving the site. When a push reports a different version, the dashboard reads the site again straight away and keeps the web server's answer. If the two keep disagreeing, the site's Environment tab says Version mismatch and names both versions: check php -v and the crontab on that server.

Sync now

  • Sync Now on the site's page syncs one site and says Site synced successfully. or why it failed.
  • Sync All on the dashboard, and the sync action on the Sites list, sync many at once (connected sites only).
  • Sync Now in the plugin's screen in wp-admin pushes from the site.

When a sync fails

The site's page shows Sync Failed with the reason, and Today's work lists Sync failing. The dashboard tries again after 1 hour, 6 hours and 12 hours. If those fail too, the site is marked offline and you get an email, Site Sync Failed. A site with no successful sync for 48 hours is also marked offline. Every attempt is on the site's Sync Logs tab.

What to check

  1. Is the site up? Open it in a browser.
  2. Is the plugin active? In wp-admin, look for RS Remote Site Manager under Plugins.
  3. Is the REST API reachable? A security plugin, firewall or CDN challenge can block /?rest_route=/rsadmin/v1/. The message on the site's page tells you which; see A site won't connect.
  4. Did something change on the site? A new firewall rule, a move to a new host or a restored backup with old keys can all stop syncing.

When the cause is fixed, click Sync Now. A successful sync sets the site back to connected.