Support Center

Setting up DNS in cPanel X

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 with cPanel X. 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 .
 

cPanel DNS redirection setup

First of all, go to your website cPanel and log in with your account credentials. Once you're logged in, go to Advanced DNS Zone Editor. You can do that by clicking on "Advanced DNS Zone Editor" icon, within "Domains" section.




This is your DNS records administrative dashboard, from where you can modify all of your domain records. You should see a "Zone File Records" section with Domain name records listed below it. 


Here you can see the list of your current domains, subdomains and redirections that you have set-up within the cPanel.

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.
 

Setting up HTML5 app subdomain

If you want to set-up 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). cPanel will append your domain name automatically. 
TTL: you can set this to "300"
Type: choose CNAME from drop-down menu
CNAME: "apps.shoutem.com"



And click on "Add record" to save your new record. 


Once your record has been saved, it will appear on list below, 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 cPanel (in respect to other domain name providers) because of some limitations set in cPanel. Because of mentioned 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. cPanel will append rest of your domain name automatically. 
TTL: you can set this to "300"
Type: choose A from drop-down menu 
Address: "
174.36.116.144"


And click on "Add record" to save your new record. 

Once your record has been saved, it will appear on list below, 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. cPanel will append your domain name automatically. 

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

TTL
: you can set this to "300"
Type: choose CNAME from drop-down menu 
Address: "apps.shoutem.com"



And click on "Add record" to save your new record. 

Once your record has been saved, it will appear on list below, 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. cPanel will append your domain name automatically into name field.
TTL: you can set this to "300"
Type: choose TXT from drop-down menu 
TXT Data: 
v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCrLHiExVd55zd/IQ/J/mRwSRMAocV/hMB3jXwaHH36d9NaVynQFYV8NaWi69c1veUtRzGt7yAioXqLj7Z4TeEUoOLgrKsn8YnckGs9i3B3tVFB+Ch/4mPhXWiNfNdynHWBcPcbJ8kjEQ2U8y78dHZj1YeRXXVvWob2OaKynO8/lQIDAQAB;



And click on "Add record" to save your new record. 

Once your record has been saved, it will appear on list below, 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. cPanel will append your domain name automatically into name field.
TTL: you can set this to "300"
Type: choose TXT from drop-down menu 
TXT Data: "
v=spf1 include:spf.mandrillapp.com?all "

And click on "Add record" to save your new record. 

Once your record has been saved, it will appear on list below, 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 subdomain 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://assets2.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