Support Center

Setting up DNS in Amazon Route 53

Last Updated: May 06, 2016 07:21PM CEST
This article covers the process of setting up the DNS records required for HTML5 apps and Agencies through Amazon Route 53. We'll cover this setup in a few simple steps. If you have any problem setting this up after reading this article, please contact our support department via email: shoutem@shoutem.com .
 

Amazon Route 53 DNS redirection setup

First of all, login to Amazon Route 53 management console. Once you're logged in, go to Hosted Zones . You can do that by clicking on "Hosted zones" , in the left menu.

This is your domain name administrative dashboard, from where you can modify all of your domain records. You should see a list of Domain name records. 



Tap on domain name that you want to use HTML5 app or Agency, and you'll see a list of DNS records for chosen domain name.



In order to set-up DNS records properly, you will need to add few DNS records.
- for HTML5 app, you will need to add only 1 record.
- for Agency account, you will need to add 4 records.

To get started, click on blue "create record set" button. 
 

Setting up HTML5 app subdomain

If you want to set-up domain name for HTML5 application, you will need to add CNAME record with following parameters.


Name: This is where you need to enter your subdomain. In the example below, we used "m", which would make the complete URL look like this m.yourdomain.com. Another popular subdomain is "app" (app.yourdomain.com).
Type: choose CNAME from drop-down menu
Alias: no
TTL: you can set this to "300"
CNAME: "apps.shoutem.com"
Routing policy: Simple



And click on blue "Create" button below to save your new record. 


Once your record has been saved, it will appear on list, and should look like on image below:

 
Congratulations, you've just successfully set up the redirection to your mobile app. Keep in mind this may take up to 48 hours to be fully activated and don't forget to add the newly added redirection subdomain to your HTML5 publish info.


Setting up Agency DNS settings

Setting up DNS records for Agency accounts is somewhat different when using Amazon Route 53 (in respect to other domain name providers such as Namecheap). Because of limitations, we will need to use A redirection instead of CNAME redirection.

 

1. Setting up redirection for your White-label dashboard

In order to allow your clients to visit your white-label Agency dashboard, you will need to set-up A domain name redirection with following parameters.


Name: This is where you need to enter your subdomain. In the example below, we used "dashboard", which would make the complete URL look like this dashboard.yourdomain.com. 
Type: choose A - IPv4 from drop-down menu
Alias: no
TTL: you can set this to "300"
Value: "
174.36.116.144 "
Routing policy: Simple


And click on blue "Create" button below to save your new record. 

Once your record has been saved, it will appear on list, and should look like on image below:

 

2. Setting up redirection for your White-label application preview URL

As you know, application users can preview their apps by loading preview URL using mobile browser.
In order to hide Shoutem branding and domain name from this link, we'll need to create another Domain name redirection with following parameters:

Name: This is where you need to enter your application preview subdomain. In the example below, we used "*.preview", which would make the complete URL look like this <app_id>.preview.yourdomain.com. 

Important note: Don't remove "*." before your preview subdomain, it is mandatory, and removing it would cause preview domain not to work!


Alias: no
TTL: you can set this to "300"
Value: "apps.shoutem.com
"
Routing policy: Simple




And click on blue "Create" button below to save your new record. 

Once your record has been saved, it will appear on list, and should look like on image below:


3. Setting up DKIM 

As Shoutem sends transactional emails on behalf of our Agencies, Agency owners will also need to add additional TXT records to enable DKIM.

You can do it by following similar steps as in step 2:

Name: mandrill._domainkey.YourAgencySubdomain. In the example above (step 1) , we used "dashboard", which would make the complete Name look like this mandrill._domainkey.dashboard.yourdomain.com.
Type: choose TXT from drop-down menu 
Alias: no
TTL: you can set this to "300"


Value: v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCrLHiExVd55zd/IQ/J/mRwSRMAocV/hMB3jXwaHH36d9NaVynQFYV8NaWi69c1veUtRzGt7yAioXqLj7Z4TeEUoOLgrKsn8YnckGs9i3B3tVFB+Ch/4mPhXWiNfNdynHWBcPcbJ8kjEQ2U8y78dHZj1YeRXXVvWob2OaKynO8/lQIDAQAB;
Routing policy: Simple 



And click on blue "Create" button below to save your new record. 

Once your record has been saved, it will appear on list, and should look like on image below:


 

4. Setting up SPF

Sender Policy Framework (SPF) is a simple email validation system, and we're using it to verify that e-mails sent by our system do not go to recipients Spam folder.

Process is very similar to Step 3.

Name: YourAgencySubdomain. In the step 1, we used "dashboard", which would make the complete Name look like this dashboard.yourdomain.com
Type: choose TXT from drop-down menu 
Alias: no
TTL: you can set this to "300"
Type: choose TXT from drop-down menu 
Value: "
v=spf1 include:spf.mandrillapp.com?all "

And click on blue "Create" button below to save your new record. 

Once your record has been saved, it will appear on list, and should look like on image below:



Congratulations, you've just successfully set up the redirection to your agency dashboard. Keep in mind this may take up to 48 hours to be fully activated and don't forget to add the newly added redirection subdomains to your agency account settings. You can check how to add subdomains to your agency account settings here.


For any additional questions please contact us via email: shoutem@shoutem.com .

Contact us

Didn't find what you were looking for? No problem! Feel free to
write to our support team.

shoutem@shoutem.com
http://assets3.desk.com/
false
desk
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete