Migrate from Plesk

Move your sites off Plesk.

A step-by-step guide to moving a WordPress site from Plesk to FlatRun: restore it into a fresh project, test it, then switch DNS. Most sites take under an hour.

Before you start

Four things to have ready.

A server with Docker

Ubuntu or Debian, 1 GB of memory at least, 2 GB recommended.

Back up everything

Take a full Plesk backup of every site, database and configuration before you start.

List your DNS records

Note every domain and record. You will point them at the new server at the end.

Lower the TTL

Lower DNS TTLs a few days ahead so the switch takes minutes instead of hours.

Steps

From Plesk to FlatRun.

  1. 01

    Install FlatRun on the new server

    Run the one-line installer, then open the dashboard and create the admin account.

    Install FlatRun
  2. 02

    Create a WordPress project

    This gives you a clean site to restore into.

    • Click New in the top bar
    • Choose Template, then WordPress
    • Set the project name and domain
    • Deploy
  3. 03

    Back up the Plesk site

    A migration plugin moves files and database together. WPvivid's free version works; All-in-One WP Migration, Duplicator and UpdraftPlus do too.

    • Install and activate the plugin on the Plesk site
    • Back up the database and files
    • Download every part of the backup
  4. 04

    Restore on FlatRun

    The restore replaces the clean install with your site, including themes, plugins and uploads.

    • Install the same plugin on the FlatRun site
    • Upload the backup parts
    • Restore the database and files
  5. 05

    Test before switching DNS

    Point the domain at the new server on your machine only, with a line in /etc/hosts (or C:\Windows\System32\drivers\etc\hosts).

    • Load the key pages
    • Try forms and logins
    • Check that images and media load
  6. 06

    Switch DNS and turn on SSL

    Update the A record, and AAAA if you use IPv6, to the new server. Once it resolves, enable SSL on the domain and FlatRun requests a Let's Encrypt certificate.

  7. 07

    Watch, then cancel Plesk

    Keep the old server for a day or two, remove the backup files from both sides, and cancel the Plesk license once the site is stable.

Moving many sites? The project's Migration tab tracks each one: what is inventoried, what has been transferred, and when DNS was cut over.

Common issues.

The site cannot connect to its database

Use the database service name as the host, not localhost, and check the credentials in the project's variables.

Files have the wrong permissions

Open the project's terminal and run chown -R www-data:www-data /var/www/html.

The certificate request fails

Let's Encrypt needs the domain to resolve to the new server. Switch DNS first, then enable SSL.

A PHP extension is missing

Change the service's image in the project's Compose file to one with the extension, then redeploy.

Ready to move?

Install FlatRun on the new server and start with one site.

Star us on GitHub