What You’ll Learn
- When to use Force Reconnect
- How to trigger the reconnection process
- What happens during reconnection
Prerequisites
- MainWP Dashboard installed and activated
- Child sites previously connected to your Dashboard
- Admin access to your Dashboard
When to Use Force Reconnect
Use this tool when:- Multiple child sites suddenly show connection errors
- You’ve migrated your Dashboard to a new server or domain
- SSL/TLS configuration has changed on your Dashboard
- Connection issues persist after resolving firewall or server problems
- OpenSSL keys may have become corrupted or out of sync
Force Reconnection
1
Navigate to MainWP Tools
Go to MainWP > Settings > MainWP Tools.
2
Find Force Reconnect
Locate the Force your MainWP Dashboard to establish a new connection option.
3
Click the button
Click the Force Reconnect button.
4
Wait for completion
The Dashboard regenerates OpenSSL keys and marks all child sites for reconnection. This process runs automatically.
5
Verify connections
Go to MainWP > Sites > Manage Sites and verify that sites are reconnecting. You can manually sync individual sites to speed up the process.
What Happens During Reconnection
- Key regeneration - The Dashboard creates new OpenSSL public/private key pairs
- Site marking - All child sites are flagged for reconnection
- Automatic sync - During the next sync cycle, each child site receives the new public key
- Re-authentication - Child sites verify the new keys and reestablish secure communication
Self-Check Checklist
- Force Reconnect button clicked
- Dashboard shows sites are reconnecting
- Previously problematic sites now connect successfully
- Sync operations complete without errors
Related Resources
- Troubleshoot Connection Problems - Diagnose connection issues
- Connection Test Status Codes - Interpret error codes
- OpenSSL Keys Encryption - How MainWP encryption works