Migration Guide
A step-by-step guide to moving your sites from Plesk to FlatRun's free, Docker-native hosting control panel.
30-60 minutes per site (depending on size)
$500+/year in license fees eliminated
Intermediate (CLI experience helpful)
FlatRun requires a Linux server with Docker installed. Ubuntu 20.04+, Debian 11+, or CentOS 8+ recommended. Minimum 1GB RAM, 20GB disk.
Create full backups of all sites, databases, and configurations in Plesk before starting. Use Plesk's built-in backup feature.
List all domains and their current DNS settings. You'll update these to point to your new server after migration.
Schedule migration during low-traffic periods. DNS propagation can take up to 48 hours, though usually completes in 1-4 hours.
Follow the installation instructions in our documentation to set up FlatRun on your new server.
Create a new WordPress deployment in FlatRun:
This creates a clean WordPress installation that you'll migrate your content into.
The easiest way to migrate WordPress sites is using a backup and migration plugin. We recommend WPvivid Backup Plugin (free version works great):
Alternative plugins that work well: All-in-One WP Migration, Duplicator, or UpdraftPlus.
In WPvivid on your source site:
For large sites, WPvivid splits backups into multiple files. Make sure to download all parts.
Now set up the receiving end:
Complete the migration:
WPvivid will overwrite the fresh WordPress install with your complete site including themes, plugins, uploads, and database.
Before updating DNS, verify everything works:
On Mac/Linux: /etc/hosts
On Windows: C:\Windows\System32\drivers\etc\hosts
Point your domain to the new FlatRun server:
DNS propagation typically takes 1-4 hours, but can take up to 48 hours. Consider lowering TTL values a few days before migration to speed this up.
Once DNS is pointing to your FlatRun server, enable SSL:
If your site uses HTTPS URLs in content, WPvivid should have preserved these. If needed, use a search-replace plugin to update URLs.
Final steps:
Congratulations! You've successfully migrated your WordPress site to FlatRun and eliminated your hosting panel licensing costs.
Check that your application config uses the correct database hostname (usually the container name, not "localhost"). Verify credentials match what FlatRun configured.
Container filesystems may have different ownership. Use FlatRun's terminal
to run chown -R www-data:www-data /var/www for web files.
Let's Encrypt requires DNS to be pointed to your server. If you're testing before DNS cutover, use a self-signed certificate or disable SSL temporarily.
If your site needs specific PHP extensions, modify the deployment's docker-compose.yml to use a PHP image with those extensions, or install them in the running container.
Download FlatRun and start your migration today.