How to map a domain with TalentLMS

TalentLMS offers two important tools when mapping domains;

First, you may rename the domain name you have chosen upon registration to your preference. (e.g, change mysite.talentlms.com to mynewsite.talentlms.com)

 Second, you can map an external domain to your existing TalentLMS domain.

In order to map an external domain, you must first follow these steps:

  1. Login as Admin and go to “Account & Settings->Domain”
  2. Use the button on the bottom that says “Set external domain mapping”
  3. On the Domain Map field, you must insert your own domain (e.g, mybusiness.com)

Once you have entered a proper domain address, it will be used immediately, however, you must create a proper CNAME DNS record on your own domain for the mapping to be effective. A CNAME, or Canonical Name, record is an entry within the Domain Name System (DNS) that specifies where a user can find your web pages, or any other URL. You’ll use the CNAME to associate your custom domain with your TalentLMS domain. Each hosting service has slightly different ways to create CNAME records. You need to have access to an administrator in order to map your domain; otherwise, you need the help of your administrator to complete this task. 

When creating the CNAME, use  the domain name that you want to map (e.g, www.mybusiness.com) on the NAME field and talentlms.com on the DATA field.
(Note that depending on your DNS hosting provider, you may have to insert www on the NAME field)

Domain mapping and branching

If you map a domain (e.g, mybusiness.com) to your original TalentLMS domain,(e.g, mybusiness.talentlms.com) each additional branch (e.g, abranch-mybusiness.talentlms.com) will be available as well as a sub-domain of the mapped domain (e.g, abranch.mybusiness.com). In order for this to be effective,you must create an additional CNAME DNS entry that maps *.mybusiness.com to TalentLMS.com (similarly with what you did for the original domain).

Notes:
(1) A few DNS providers do not permit the creation of Wildcard DNS entries. In this case, you must create individual DNS entries for your branches. For example; instead of *.mybusiness.com, use a DNS entry for abranch.mybusiness.com directly.

(2) Whenever we cannot find a match subbranch for a given URL we will re-direct the user to the www domain. For example if the end user uses secondbranch.mybusiness.com and there is no secondbranch, we will redirect him to www.mybusiness.com

(3) A common issue faced when mapping www.mybusiness.com instead of mybusiness.com (without www in front of it) *within* TalentLMS. This will lead to not being able to use branches through mapping properly. Technically, the mapping with this setting needs to be done in sub level (e.g, *.www.mybusiness.com) .

 In simple words *do not map* www.mybusiness.com within TalentLMS. Instead, use mybusiness.com. Your end users will still be able to use www.mybusiness.com since it will be redirected to the main mapped domain.

As a final note, if you create a branch named "www" this will be used as a normal branch and will not redirect users to the main domain.

(4) You should never use a CNAME record for your root domain name (i.e. mybusiness.com). A root domain is mapped with an A record with an IP. If you want to map your root domain with TalentLMS directly, you should use one of our IP's (e.g, 162.209.40.115). 

For more information on the differences between A and CNAME records, click on the following link: http://support.dnsimple.com/articles/differences-between-a-cname-alias-url/

(5) If you prefer to host another site on your www domain, it is a good idea to use a second level sub-domain for branching. Technically, www.mybusiness.com will point to your main site. lms.mybusiness.com can point to your main TalentLMS domain and branches will be mapped as branch1.lms.mybusiness.com

Using SSL with domain mapping

Note that SSL on custom domains are only available on Premium plans. If you want SSL on your custom domain, you need to provide us with a valid certificate. In order to issue your certificate, we must provide you with a CSR. The data we need from you to produce the CSR is as follows;

- Hostname (e.g. https://talent.example.com)
- E-mail address
- Organization name
- Organizational Unit (optional)
- City
- State or Province
- Country

You may then use the CSR (if needed, source: apache mod_ssl) in order to issue the certificate and optionally a certificate chain, that will be used to configure SSL for your custom domain.

Feedback and Knowledge Base