Custom Domain Configuration
The Custom Domain & Whitelabel add-on lets you promote your organization's brand using a custom URL for your Run portal. Configuring your Custom Domain is simple, but there are a few requirements to make it work.
Pre-requisites
Before configuring your Custom Domain in your Admin, ensure you have:
- A domain or a sub-domain for your organization; you can get one from the several domain providers in the market. Ensure that you can edit the DNS (Domain Name System) records for your custom domain in the settings of the domain provider.
- The Custom Domain & Whitelabel add-on is activated in your profile. Check out our Pricing page for more information.
The Custom Domain & Whitelabel add-on is available per profile. If you need to use a custom domain in another profile, you will need to acquire another add-on.
Adding your Custom Domain
To configure your Custom Domain add-on for your profile, you need to access your Run module and click on the tab Domain. Paste your domain and sub-domain in the respective fields.
You can configure the e-mail domain for messages sent from your application, choosing between one of the options:
- Use only the domain name: e-mail address will contain only the domain. For example noreply@mycompany.com
- Use full address: e-mail address will contain both domain and sub-domain. For example noreply@portal.mycompany.com
Once you are done, confirm your settings to start mapping your Custom Domain.
DNS Configuration
Once the Custom Domain is added, a new tab will be displayed with the DNS registers you need to add to your domain provider's admin console.
Once on your domain provider's console, locate the DNS manager / DNS Settings. You will need to create a record for each of the DNS registers.
Create a record of type CNAME and copy the Key and Values into your record. In total will you will create one record for the Endpoint and SSL certificate, and three records for the E-mail. Once you have it all set up, you can click on the button Check records to verify your configuration.
You can hover over the icon on the right side of each record for more details about the status.
Due to DNS propagation, TagoIO might take a while to identify the registers in your Domain provider. If, even after 30 minutes, your domain is still not working, try verifying if the records were correctly created in your DNS Manager / DNS Settings.
If you click on Check Records without setting up the SSL certificate, the domain will be mapped to your portal, however, the mapped domain name will be disabled. SSL certificate is mandatory since custom domains work via the HTTPS protocol.Related Articles
Custom Domain & Whitelabel
Adding the Custom Domain & Whitelabel add-on will unlock the following configurations in the Run module. Ability to choose a custom URL for the application For example, if your current company domain is mycompany.com, you can add your Run using ...Custom Widget
Custom Widgets are very versatile, allowing you to build whatever you need to suit your application’s needs. The widget can be built with plain web technologies like HTML, CSS, and JavaScript, but keep in mind that at least some JavaScript is needed ...Configuration Parameters for Devices
Configuration Parameters are key-value pairs that enable you to customize the behavior of your Devices in different scenarios. For example, you can use them to specify how to decode data or send downlink messages, filter your devices on Widgets, or ...Custom mobile app
Add the Custom mobile app add-on to keep the deployment of your own mobile app. Your mobile app will be completely white-label, so that when your clients locate and download it from the App Store & Google Play it’ll be a professional looking ...Custom Widget Parameters
Parameters allow you to send a list of keys and values to your custom widget. One use of these parameters is to change the way your code behaves. You can have two widgets pointing to the same link, but exhibiting different behaviors. Each parameter ...