DISCLAIMER: With the introduction of the Domain Management feature, the Custom Domain app will no longer be used for configuring custom domains. Please see Domain Management: Configuring custom domains for more information on configuring custom domains.
If Domain Management is activated on your platform then, instead of the configuration settings for custom domains, this app now shows a message and a link to redirect to Domain Management.
Please Note: In order to improve the security of your platform, as of November 1, 2021, Docebo has discontinued the support of second-level domains.
Introduction
With Docebo’s Custom Domain app, you can set a custom domain name for your platform. This article outlines how to activate and configure the Custom Domain app in your platform.
Use case scenarios
A useful scenario for the Custom Domain app is when, at your company, you as a platform Superadmin would like to redirect your users to a different URL than the docebosaas.com URL that was provided with the contract. Updating the docebosaas.com URL to a known company URL will make it easier for the learners to remember and navigate the platform’s URL.
First, make sure that the custom domain that you would like to change the platform URL to is purchased and owned by your company. Additionally, your company will need to purchase an SSL certificate to ensure that the site is secure when the redirect is in place. Lastly, your company will need to update your domain name system (DNS) settings once the custom domain is added to the platform along with the SSL certificate. Once the custom domain is created and selected in the platform, the SSL certificate is successfully uploaded, and the DNS settings are updated, the redirect will be in place. With the custom domain enabled, the user can simply go to the site via the custom domain, for example at https://learn.mycompanyname.com, to access the platform as opposed to the docebosaas.com URL.
What is a domain?
A domain name is a unique branded name that identifies a website. Learners can use this domain to access your learning platform. Your domain must be registered with a domain registrar.
How do I register a domain?
In order to replace your standard Docebo domain with a custom domain, you first need to register a domain with a domain registrar if you have not already done so. There are many options available to you when it comes to domain registrations. When you register a domain, your contact details are connected to it. The Internet Corporation for Assigned Names and Numbers (ICANN) oversees the DNS and gives registrars the ability to register a domain to a single individual or corporation.
Please Note: Docebo does not provide domain registration or DNS services and cannot provide support for a domain registered with a third party.
Activating the Custom Domain app in Docebo
Activate the Custom Domain app as described in the Managing Apps & Features article of the Knowledge Base. The app is listed in the Docebo Additional Features tab.
Configuring the Custom Domain app
Once the Custom Domain app is activated, your platform is accessible at your custom domain once the app is properly configured and your DNS record is updated according to the DNS record configuration requirements outlined in the section below. The order in which you complete these does not matter.
Please Note: Docebo does not provide support for non standard DNS configurations, like those using Cloudflare.
To configure the app in your platform, access the Navigation menu > Configuration (spanner icon) > Platform setup and tools > Domain management. Type in your domain name with the prefix www in the Domain Name text box. For example: www.yourcompany.com and not yourcompany.com.
Click Save Changes to confirm.
On the next page, confirm that your custom domain name is correct by selecting the Confirm checkbox, press Continue to submit your domain name, and return to the Settings page. If your custom domain name is incorrect, press Back to make corrections before re-submitting the information.
Please Note: Any domain name containing the extension
docebo,dcbstatic.com, or capital letters will not be accepted.
Once your domain name is accepted, on the Settings page you will see both a confirmation message and message warning that you are not able to update your domain name for a few minutes. Additionally, you'll see the custom domain DNS record configuration requirements provided for your information. For third-level domains, you will require only a CNAME entry to redirect your custom domain name to yourbusinessname.docebosaas.com. If your domain’s DNS record is updated according to the below DNS record configuration requirements, your platform will be accessible at your custom domain.
Please Note: Since November 1st, 2021 second-level domains are no longer be supported.
We strongly suggest to not use 4th-level domains as you may experience problems with HTTPS certificates.
DNS record configuration requirements
Your platform is accessible at your custom domain once your domain’s DNS record is updated according to these DNS record configuration requirements and the Custom Domain application is configured. The order in which you complete these steps does not matter.
Typically DNS servers are provided by your domain registrar, your hosting provider or they are self-hosted on your corporate network. If you are unsure how to edit DNS records you may need to contact your provider for further assistance. For a third-level custom domain (an example of a third-level custom domain is subdomain.yourcompany.com or www.yourcompany.com), you will only need to provide a CNAME record, redirecting your third-level domain to yourcompany.docebosaas.com.
To secure communications with your custom domain, it's recommended HTTPS on your custom domain with Docebo's HTTPS app.
WARNING: If a custom domain is added without the required SSL certificate, the Superadmins and Power Users of the platform may be unable to impersonate users. This will also negatively affect the ability of Docebo Support to access the platform and provide effective support.
When choosing your email sender address, remember not to reuse your custom or Extended Enterprise domains, as most DNS services do not allow for a CNAME and SPF record to coexist for the same domain. We suggest that you find a similar name. As an example, if you custom domain is learning.mydomain.com, you can configure a sender email address as learning@mydomain.com or even use a 4th level domain (for example, if you custom domain is learning.mydomain.com, use noreply@something.learning.mydomain.com as sender email address).