After you create a temporary domain for your DreamPress site (example.dream.press) and have added your new domain as DNS Only (example.com), you are ready to migrate. To migrate, use the domain name changer in the panel.
You can use the domain name changer in the DreamPress dashboard to change any temporary domain, not just dream.press subdomains.
Preparing your domain for migration
Confirm the following for the domain you are migrating TO. If any of the following items are not configured, your site will not connect after it's migrated from the temporary domain.
The domain you migrate TO cannot be hosted. If it is, you must remove hosting for the domain before proceeding. You can do this by setting the domain as DNS Only. This is so the domain can safely be migrated without breaking a live site.
Remove any 'previously existing' mysql hostnames
This step is extremely important.
If a mysql hostname already exists in your panel for the new domain, you must delete it first. For example, navigate to the (Panel > 'Goodies' > 'MySQL Databases') page. If you have databases, you'll see hostnames listed under the name of the MySQL server. This MySQL server will either have a Shared server name, or a VPS name. This example shows a Shared MySQL server named 'carme' on which the hostname already exists:
If you are moving DreamPress to a new domain called example.com, search for mysql.example.com. If you see it listed, delete it.
If it exists and you do not remove it, your panel will not be able to update your database with the correct hostname. Since it will not connect to the correct hostname, you'll see a 'Error establishing a database connection' error when you migrate.
If you've created DreamPress correctly, the hostname will show under your DreamPress server. The DreamPress servername starts with 'dp' and a long series of letters and numbers. Here's an example:
If this already exists for your site, leave it as it is.
Remove custom DNS
Make sure there are no Custom DNS A or CNAME records on the domain you are migrating TO (if any exist that point to a different web host). If there are, delete the custom records. Other Custom DNS records are fine to leave in place.
Step 1 — Changing your domain
JetPack Premium will not automatically connect when you rename your domain. To reconnect, simply log back into your WordPress admin page. JetPack should reconnect after you log in.
To change the DreamPress domain:
- Navigate to the (Panel > ‘DreamPress’ > ‘Dashboard’) page.
- Click the 'Manage' button next to your domain.
- Click the 'Domain' tab on the bottom left.
- Enter a new domain or choose an existing domain from the dropdown menu
- Finally, click the Change domain button to finish.
- It will take 4-6 hours for the DNS to update for your new domain at DreamHost.
Step 2 — Waiting for your DreamHost DNS to update
As stated above, it can take 4-6 hours for the DNS to update at DreamHost. If you point your DNS at your current host to DreamHost before the DNS has updated on DreamHost's servers, the site will not connect.
It's recommended that you wait 4-6 hours before updating your DNS at your current host.
Step 3 — Updating your DNS at your current host
Error establishing a database connection
This error most likely occurred because you did not remove the old hostname as mentioned above in the section titled 'Remove any mysql hostnames'.
The reason is because the panel still has the old hostname for the 'DNS Only' site still set up on the (Panel > 'Goodies' > 'MySQL Databases') page. Since this wasn't deleted, the panel could not move the old hostname to the DreamPress database.
To fix, you must update your wp-config.php file with the OLD hostname. Navigate to the MySQL databases page. Search for your DreamPress database. Note the hostname.