How to add a Custom Domain

How to add a Custom Domain

If you’d like to use a custom domain with your Kong store, then it’s really simple to do so. This guide will walk you through purhcasing a domain if you don’t already have one, setting the domain up and then adding it to your Kong store.

Do you already have a domain?

If you already have a domain that you’d like to use, then you can skip ahead to the next section. If not, then you’ll first want to purchase a domain. It’s quick and easy to do – the hardest part is choosing one that you like! If you’re looking for somewhere to purchase your domain, we’d recommend GoDaddy. They’re easy to use and offer great support.

Guides for popular domain providers

Configuring your domain

The first thing you need to do is configure your domain to point to your Kong store. This involves setting up a CNAME record. The method varies between domain hosts, but here’s how it generally works:

  1. Sign in to your domain host account and choose the domain you want to configure.
  2. Find the page for updating your DNS records. This might be called something like DNS Management, Name Server Management or Advanced Settings.
  3. Look for the CNAME records for your domain. There might be one or more already set up that look something like this:
    • Host/Alias/Name: www
    • Destination/Value: yourdomain.com or @
  4. You need to add or edit the www CNAME record, and set the Destination/Value to your Kong store URL, which will look something like your-store.kong365.com. You can find this by logging in to your Kong store then clicking on Settings, followed by Domains. Once on that page, look for a field with a label of CNAME Value. It’s easiest to copy and paste it into your CNAME record.
  5. Save your changes and wait until they take effect.

Forwarding your domain

If your domain host allows you to set up domain forwarding, then that would allow you to forward your non-www domain to the domain with www at the start, for example mystore.com would forward to www.mydomain.com. This means that visitors typing in your domain with or without the www. at the start will always reach your store.

As before, the method will vary between domain hosts but this is generally how it works:

  1. Sign in to your domain host account and choose the domain you want to configure.
  2. Find the page for forwarding your domain. This might be called something like Domain Forwarding, Web Forwarding or Advanced Settings.
  3. Add or edit the forwarding, and set the target or destination to your domain with www. at the beginning.
  4. Save your changes and wait until they take effect.

If you can't forward your domain

If your domain host doesn't allow you to forward your domain, there's a free alternative from EasyRedir. Here's how to set that up:

  1. Sign in to your domain host account and choose the domain you want to configure.
  2. Find the page for updating your DNS records. This might be called something like DNS Management, Name Server Management or Advanced Settings.
  3. Look for the A-record for your domain. It will usually be labelled as @ or sometimes your domain without www. at the start.
  4. Edit the A-record, and change the Destination/Value/IP Address to 54.68.182.72.
  5. Save your changes and wait until they take effect.

Adding your domain to your Kong store

The last step is to add your domain to your Kong store. Here’s how to do it:

  1. Log in to your Kong store.
  2. In the left-hand navigation, click Settings, followed by Domains.
  3. In the Primary Domain field, type in or paste your domain name ensuring to include the www. part.
  4. Click the Verify button to check that your CNAME record has been set up correctly.
  5. Save your settings.

Redirect to your primary custom domain

Once you’ve saved your domain, you’ll see an additional checkbox titled “Redirect visitors to my primary custom domain”. Ticking this will mean that any visitors that try to access your Kong subdomain URL, for example your-store.kong365.com, will be redirected to your Primary Custom Domain.

This setting is recommended for most stores, but it’s completely down to personal preference.

Having problems?

Take a look at our troubleshooting guide, which has solutions to some of the most common domain configuration problems.

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk