Table of contents

Why could my WordPress migration fail?

Author:

Published:

Updated on August 16, 2024

Reading Time: 1 min read

WordPress Migration #

For the WordPress FTP migration tool to work correctly, certain conditions must be met. These conditions are usually met by default unless changes have been made to your WordPress installation.

What to Do if a WordPress Migration Has Failed

If your migration fails, adjustments may be needed to allow the migration tool to work correctly:

  1. Check the Location of wp-config.php:
    • The migration tool looks for the directory with the wp-config.php configuration file. If you’ve manually moved the wp-config.php file to another directory (sometimes done for security reasons), you need to move it back to be with the rest of the core WordPress files.
  2. Verify File and Directory Permissions:
    • Ensure file and directory permissions are consistent with WordPress best practices: directories should be set to 755 and files to 644.
  3. Whitelist Migration Tool IPs:
    • The IPs used for the FTP migration tool should not be blocked: 185.146.165.4 & 45.8.227.14. If you use a web application firewall (WAF), ensure these IPs are whitelisted.
  4. Confirm Domain Name Settings:
    • Ensure the website’s domain name points to the correct web host. If the nameservers for the domain name don’t point to the right host, the migration will fail.

If you’re having trouble diagnosing the issue, please feel free to contact support within your StackCP account from the support area.