return to :: documents
Domain Name

Setting up a custom domain name is not for the faint of heart. It is sort of like making soufflés, in that it will take a little perseverance and a lot of Google searches.

In this guide, we are going to assume you have already purchased a domain name. If not, we highly recommend iWantMyName (note: affiliate link). We use them to manage our own domain names and they are stellar.

Summary of what you will need to do:

  1. Purchase a domain name.
  2. Configure your project to use the domain name (in its settings page).
  3. Point a CNAME record to your <yoursite> subdomain

Note: It may take up to 72 hours for the Internet to learn about the new domain you create the record, so please be patient.

Custom Domain Guide


The root url will resolve to one of the following files in the top-level folder (in order of precedence):

Pancake Setup

You will need to configure your project to use it. On Pancake, navigate to your project's settings page, and add your URL.

You may have to three URLs configured per project.

Configure Your Subdomain

Configure your DNS provider to make your desired domain name be an alias (i.e. create a CNAME record) which points to <yoursite>, the current URL for your site.

That is, if you purchased, have a Pancake site at, and wanted your site to be at, you would create a CNAME record for with the value

Again, it may take up to 72 hours for your new domain name to start working.

Using a Root Domain

This section is for those who wish to use a root domain name without any subdomains. For example, you want your site to be at, instead of a URL with a subdomain like or

Please be forewarned that this is highly discouraged as it hampers our efforts to ensure your site is up and running. Should our IP address be compromised, or if we need to switch our frontend IP for any other reason, you would have to change your DNS record yourself, which may lead to down time in the event that we cannot provide sufficient advanced notice. In contrast, a CNAME record will allow us to change the underlying IP address, and the changes will be transparently applied to your domain as well.

However, if you're willing to accept this risk, you may set up your root domain with an A record pointing to the following IP address:

If you want to use both a subdomain and your root domain at the same time, e.g., and, follow both sets of instructions above, and add both URLs to your project.