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 for setting this up.
Adding A CNAME ValueFirst, 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.
When you find the DNS settings, select the "Add New Record" or a similar option depending on your domain provider. You'll want to assign the following CNAME values in your DNS settings:
- Name (subdomain) - Whether it's "app.yoursite.com", "m.yoursite.com" or whichever subdomain 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: apps.shoutem.com
- 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.
If you can see only the A type redirection, you are probably in the wrong place. A redirection is used to redirect to a static IP address, instead of a dynamic address like the one that we use.
After you set this up, please wait up to 48h to give the DNS server of your domain provider enough time to refresh itself and process the change.
Step by step guides for specific domain backendsIf you have a website hosted with some web hosting company, or only a domain bought for the purpose of hosting your HTML5 app, 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:
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 CNAME value for domain / subdomain that I own: www.yoursite.com. I need to point the address m.yoursite.com to apps.shoutem.com"
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 m.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 HTML5 app correctly. In order to see how to set up this domain in our app builder, please check this post.
If you have any questions, please let us know!