This article explains how to change the name of your DreamPress site to a different domain name. These instructions can be used for a regular domain name like 'example.com' or a DreamPress temporary domain like 'example.dream.press'.
Make sure the domain you're changing the name to is already set as DNS Only. You can then 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.
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 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 'bowl' 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 DreamPress page.
- Click the 'Manage' button next to your domain.
- Click the 'Domain' tab at the top, and then click 'Choose existing domains'.
- Select your domain name from the drop-down menu, and then click the Change Domain button to finish. The following warning appears notifying you that any previous backups from the old domain name will be removed.
- It takes 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 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.