Note: This article concerns solely private cloud-hosted eFront portals. The guidelines below do not apply to on-premise deployed installations. To learn how to set up domains at a branch level check this article.

If you have recently subscribed to eFront and you want to use a domain name of your choice (e.g., training.example.com), here’s how to do it.

Your eFront installation comes with a name under the efrontlearning.com domain, provided to you upon initializing your subscription. In our example, we will use the name example.efrontlearning.com.

To use a domain name of your choice (e.g., training.example.com) with your current eFront installation:

1. Visit your DNS provider's website
2. Go to the DNS settings
3. In your DNS settings, add the following CNAME record:
   CNAME training.example.com -> example.efrontlearning.com
4. To create Branch URLs (e.g., branch1.training.example.com, branch2.training.example.com, etc.), also add the following record:
   CNAME *.training.example.com -> example.efrontlearning.com

NOTE: in case you want to use your own domain for your eFront portal, and if it is hosted by our servers, we offer a free of charge SSL certificate (so that your portal will securely operate under HTTPS). To request it, or to receive further guidelines on the SSL certificates, please contact directly our support team.

Enabling the mailing service

To enable the mailing service for your eFront installation, you have to create the following TXT record in your DNS settings.

1. Visit your DNS provider's website
2. Go to the DNS settings
3. Create a new TXT record (our support team will provide you with the actual values you need to enter) 

• Hostname: Enter the host name for the TXT record. For example, type @ to map the record directly to your domain name, or enter the subdomain of your host name such as www or mail.
• TXT Value - Enter the value you want to assign to the record.

For example:

(these are just example values, use the values provided to you by our support team)

• Hostname: example.domain.com
• Value: v=DKIM1; k=rsa; h=sha256; p=WUXy9MuMkv7vvvzS[...]

Configuring DNS to use with Branch URLs

To have your Branch URLs follow a format like 'branch.training.example.com', you need to refer to 'step 4' in the previous section and add the CNAME record: *.training.example.com. Then, you have to explicitly define the 'Domain name for branch' in the respective field.

Let's say we want to create a Branch at 'operations.training.example.com':

1. In your eFront portal, go to 'Home’ -> 'Branches' -> 'Add Branch'
2. Fill in a name for your Branch
3. Fill in the Branch’s complete URL, in our case: operations.training.example.com

A domain other than '*.training.example.com' as Branch URL (e.g. foo.com)

To create a Βranch at a new domain, different than your eFront domain:

1. In your eFront portal, go to 'Home' -> 'Branches' -> 'Add Branch'
2. Fill in a name for your Branch
3. Fill in the Branch’s domain name, in our case: foo.com

1. Go to the domain’s (foo.com) DNS settings
2. Add a CNAME record pointing to your eFront installation’s default domain name: CNAME foo.com -> example.efrontlearning.com
3. To use this as a parent Branch for other Branch URLs (e.g., branch1.foo.com, branch2.foo.com, etc.), also add the following record:
   CNAME *.foo.com -> example.efrontlearning.com

Note: As you did for the main domain, you have to explicitly define the subdomain name in the 'Domain name for branch' field for each sub-Branch.

For more general information on Branches, instead,  follow this link.