Permalink
Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
85 lines (45 sloc) 4.87 KB

Overview

Your begin.app URL is pretty nice, but it's probably not as good as that great domain you've been wanting to use with your app. We've got you covered!

Begin allows you to add your domain to your Begin app through a simple process called domain mapping (also sometimes called host mapping).

Once mapped, you can always swap out your app's domains at any time, or get rid of them entirely – your old begin.app URLs will continue to work.

Mapping your domain

Enter production and staging domains

The first step in domain mapping is to enter the domains you'll be using.

Begin's first-class support for staging environments means you'll need to add a staging domain too. If the domain you'd like to use is, say, www.zombo.com, we'd suggest keeping it simple and setting your staging domain to staging.zombo.com – but really it can be whatever you want – including another domain entirely (like zombostaging.net).

In the next step, you'll enter the first two values in your DNS provider's interface, which will prove you own your domains and generate your SSL certificates.

Generating SSL certificates

In this step, you'll need to add two CNAME values to your DNS provider in order to generate your SSL certificates.

During the SSL verification step, the first part of name gets entered as your CNAME subdomain, and the value is inputted as the value. For instance, when you're provided the following CNAME entry:

  • Name: _2f9b34277e4b159e0beaa859e8802a93.www.example.com
  • Value: _58cb94c5d71976edd03e8303fc1a126b.acm-validations.aws.

You'll add a CNAME subdomain of _2f9b34277e4b159e0beaa859e8802a93 within your example.com zone, and set its value to _58cb94c5d71976edd03e8303fc1a126b.acm-validations.aws..

Due to the eventually consistent nature of DNS-based verification, it may take a few minutes for your changes to get picked up. Check back after a few minutes, and your values should be green, and you should be able to advance to the next and final step.

If for some reason after more than a few minutes your domains haven't verified, make sure that you've correctly entered the settings into your DNS.

Should you continue to have trouble, please don't hesitate to reach out to support.

Domain mapping

In the final step, you'll add the final two CNAME (or ALIAS, if using naked domains) values to your DNS provider. This points your domain at your new Begin domain distribution.

For instance, when you're provided the following CNAME entry:

  • Name: www.example.com.
  • Value: pi1f6fddqd0dje.cloudfront.net

You'll add a CNAME subdomain of www within your example.com zone, and set its value to pi1f6fddqd0dje.cloudfront.net.

Please note: Begin does not presently verify you have correctly completed this step, so you may want to use a service like DNS Checker to validate your changes.

Mapping naked domains

A naked domain (also referred to as a zone apex) is simply a domain set up to respond to requests without a subdomain. For example:

  • https://begin.com is a web address using a naked domain
  • https://docs.begin.com has a subdomain, and is thus not a naked domain

Begin supports mapping naked domains, but your current DNS provider needs to support it as well.

Specifically, your DNS provider requires the ability to add ALIAS records (also sometimes called ANAME, or A ALIAS), in order to create a mapped naked domain.

Here are a few DNS providers that we are aware of that support ALIAS records for mapping naked domains:

If you aren't using a provider that supports ALIAS records, or you aren't sure, we suggest using a subdomain (such as www) when mapping your Begin app's domain.

Starting over

Something not looking right? No sweat, DNS can be finicky. If you need to hit the reset button, just click Start over (or, if you've finished mapping your domain, Delete domain mapping).

Your app will then be restored to its original yourappname.begin.app URLs, and you'll be able to re-map your domain again.