If you purchased your domain through Amazon Route53, the steps in this article will help you configure DNS settings for WP Engine. This step is required in order to go live with your domain on the WP Engine platform.
Please note: Before taking these steps, be sure to add your domain in User Portal.
Step 1: Locate your DNS information in User Portal
First, login to your WP Engine User Portal to locate the information needed to configure DNS. You will find this information on the Overview page for your WP Engine environment. Locate the IP address and CNAME on this page.
Make a note of these settings, and leave this tab open as you continue through the following steps for easy copying!
Step 2: Login to Amazon Route53
Now, login to your Route53 dashboard at console.aws.amazon.com/route53/. You will be able to manage your DNS zones from the Hosted zones section from the left-hand navigation.
From this page, you will be able to add, edit, and configure DNS records for your domain.
Step 3: Update DNS Records
Now it is time to plug in the settings from the WP Engine Overview page into your Amazon Route53 settings. Before doing this, it’s time to make a choice:
- Option A (preferred): point your nameservers to Cloudflare. If your site is migrated internally with WP Engine, DNS changes won’t be needed.
- Option B (still okay!): point your A record to WP Engine. This will work just fine, but you will need to update your DNS records if your website is ever migrated to a new server. This method keeps your Domain and DNS management at Amazon Route53.
- Option C (advanced–clusters only): Use Alias record to point to ELB with Route53 DNS. If you are on a custom dedicated plan with clustered server architecture, you may optionally set an Alias record to point directly to the ELB name for your cluster.
Option A: Point Nameservers to Cloudflare
Cloudflare is a service that helps manage your DNS, as well as offering several security benefits. You can configure CDN, SSL, filter users, and even enable DDoS protection on some Cloudflare plans. Before continuing, open a new tab and navigate to www.cloudflare.com. Here you can sign up for a new plan with Cloudflare. There are many plan levels, but for the purposes of this article we will show how to use the free plan.
After signing up, enter your domain name when prompted. Cloudflare will then look up your DNS records and mirror them. In the meantime, select your Cloudflare plan (we selected free):
After selecting your plan, Cloudflare will display your Amazon Route53 DNS records. Remove the A record for your root domain, then configure a CNAME record for it instead.
If your “www” record on this page is set to be a CNAME alias of your root domain, or of your WP Engine CNAME, no further steps are needed. If not, you will need to perform the steps above for the “www” record as well.
When you continue, you will be prompted to change your nameservers with Amazon Route53. This step is performed in the Amazon Route53 dashboard. Leave the Cloudflare page open for easy copying of the new nameservers.
In your Amazon Route53 settings, select the nameserver settings (this will be the record with “NS” in the Type column). In the pane at the right, replace the existing nameservers with the one from the Cloudflare dashboard instead. The nameservers can take some time to fully switch over, but once the change is fully in effect your Cloudflare settings will kick in to direct your traffic to WP Engine! To learn more about Cloudflare’s other services like CDN and SSL, head to Cloudflare Best Practices.
Option B: Point Your A Record to WP Engine
If you prefer to go without Cloudflare, that’s okay! You can configure the DNS settings needed right in the Amazon Route53 dashboard. However, keep in mind that you will need to update your DNS if your website is ever migrated to a new server.
On the Amazon Route53 dashboard, click Hosted zones from the left-hand navigation and select your domain from the list. Here you will see a list of existing records. If you see any existing records with “A” and/or “CNAME” types in the list, you will want to edit these records. Otherwise you will need to add new records.
In the example above, an A record and CNAME record exist–these records will need to be edited to match the IP address and CNAME showing on the Overview page in your User Portal.
Start with your root domain, making an A record for it. Leave the “Name” field blank, and select “A record” from the dropdown menu. Last, in the Value field, enter the IP Address from the Overview page in User Portal.
At this stage you can also edit the TTL, or time for your changes to take effect. 300 seconds, or 5 minutes, is the default which usually works for most users. If you prefer, you may adjust this up or down. Last, save the record to ensure your changes take effect.
Now, create or edit the CNAME record. For name, enter “www” in the box and ensure “CNAME record” is selected from the dropdown menu. In the “Value” field, enter your WP Engine CNAME from the Overview page.
Feel free to adjust TTL for this record at this stage as well, before saving your changes.
Now all that is left is to wait for propagation of your changes! In the meantime, feel free to take this time to review our Going Live guide and ensure you have taken all the steps.
Option C: Use Alias Record to Point to Cluster ELB
If you are on a custom dedicated plan with a cluster, you may use an Alias record in your dashboard to point directly to the Elastic Load Balancer (ELB) for your cluster. To do this, you must perform a lookup of your [environment].wpengine.com CNAME.
In a Terminal window, type the following, replacing “environment” with your WP Engine CNAME:
dig +short environment.wpengine.com
You should see two domains and two IP addresses appear. One domain will be lbmaster-123456.wpengine.com, and the other will be a long string ending in .elb.amazonaws.com. The latter is the ELB domain to which you will need to point your Alias record with Route53.
In your web browser, navigate to the Route53 console and select Hosted zones from the left-hand navigation. Select your root domain (mycoolnewdomain.click in this example) and look to the right side to make edits. Just under the “Type” of record, select the “Yes” radio button next to Alias, and enter the .elb.amazonaws.com domain in the Alias Target box. Click Save Record Set to finish editing the record.
Now locate the “www” version of your domain in the list (www.mycoolnewdomain.click in our example) and ensure it is either set as a CNAME to your root domain, or that it is also aliased to the ELB domain.
Once your record changes propagate across the web, your DNS will be properly configured for your WP Engine domain! In the meantime, make sure you’ve reviewed our Going Live guide to ensure you haven’t missed any important steps.