Support Center

What DNS settings do I need to change to setup my white-label Agency account?

Last Updated: May 06, 2016 11:28PM CEST
For users to be able to access your white-label Agency dashboard, you must first provide Shoutem with two subdomains that we can use to point to your dashboard. Since there are many different domain providers, we suggest checking the list of Providers in this article (listed below) to find if we have a step by step example for the one that you are using. If you can't find the example for the domain provider you are currently using, drop us an e-mail using this form and we will do our best to help you and add the guide for it aswell.

In order to set the redirection correctly on your domain, you want to find the DNS settings under your web domain account. DNS settings are separated into a few categories, including "A Record" and "CNAME" values. We'll be working with CNAME and A records for setting this up.

First, you need to find your domain's DNS area. This can be labeled as "DNS Settings", "DNS Control", "DNS Manager", "Advanced Zone Control" or something similar. If you can't find something like this, please check the list of instructions for specific domain providers below.


Step by step guides for specific domain backends

If you have a website hosted with some web hosting  company,  or only a domain bought for the purpose of hosting your Agency dashboard, it is probable that your domain provider uses one of the control panels depicted here. If they are, feel free to check the step by step instructions that we prepared for you:
 

When you find the DNS settings, select the "Add New Record" or a similar option depending on your domain provider . For Agency account, you will need to add 4 records in total.
 

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.

Record type: A record

Name (subdomain) - Whether it's "dashboard.yoursite.com", "apps.yoursite.com" or whichever subdomain to access your agency dashboard you've chosen, you'll need to add that subdomain in this area.
Points to /
Host name / Alias / Destination / Record Value - Point your subdomain to: 174.36.116.144
- TTL Value - Not all control panels have this. If you do, leave this value at its default. No need to change this.


Once these values are entered, confirm these settings by selecting "Save", "OK" or "Submit" depending on your provider.
 

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:


Record type: CNAME record
Name (subdomain) - You can add subdomain like this "*.preview.yoursite.com" or "*.apppreview.yoursite.com". 
Points to / 
Host name / Alias / Destination / Record Value - Point your subdomain to: apps.shoutem.com

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

- TTL Value - Not all control panels have this. If you do, leave this value at its default. No need to change this.

Once these values are entered, confirm these settings by selecting "Save", "OK" or "Submit" depending on your provider.
 

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:

- Record Type: TXT
- 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
- Record Value / Text / TXT Data: v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCrLHiExVd55zd/IQ/J/mRwSRMAocV/hMB3jXwaHH36d9NaVynQFYV8NaWi69c1veUtRzGt
- TTL:   Not all control panels have this. If you do, leave this value at its default. No need to change this.

Once these values are entered, confirm these settings by selecting "Save", "OK" or "Submit" depending on your provider.
 

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.

- Record Type: TXT 
- Name: YourAgencySubdomain. In the step 1, we used "dashboard", which would make the complete Name look like this dashboard.yourdomain.com. 
- TTL:
Not all control panels have this. If you do, leave this value at its default. No need to change this.
- Record Value / Text /  TXT Data: "v=spf1 include:spf.mandrillapp.com?all "


Once these values are entered, confirm these settings by selecting "Save", "OK" or "Submit" depending on your provider.

After you set this up, it can take up to 48h to give the DNS server of your domain provider enough time to refresh itself and process the change.

 

I read all of this, but can't seem to do it. What now?

Shoutem understands that domain changes or additions can be a confusing process, especially since the wording can be a bit different from case to case based on the provider that you are using. We are doing our best to cover all of them, but it is possible that yours isn't on the list. In this can we suggest either contacting us so we can help you find a solution or contacting the support staff of your domain provider.

If you choose the latter solution, the following information should clearly state your intentions to them.

"I need to create a few records value for domain / subdomain that I own: www.yoursite.com, as described in this article:
http://support.shoutem.com/customer/portal/articles/2421389-what-dns-settings-do-i-need-to-change-to-setup-my-white-label-agency-account " 

In this scenario, make sure:

- That the domain that you will point to apps.shoutem.com is not used for any purpose at the moment.
- Subdomain dashboard.yoursite.com is not created at the moment

Thank you for reading this walkthrough. We hope that it helped you set up the custom domain for your Agency account correctly.

In order to see how to set up these domains in your agency account settings in app builder, please check 
this post.

If you have any questions, please let us know!


 

Contact us

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

shoutem@shoutem.com
http://assets1.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