Articles on: Settings & configurations

Connect custom domain to Maglr

Maglr publications can be published and viewed on a custom domain of your chosen host or provider. A custom domain will still allow you to select filters and organise your publications on that domain.

An example of a custom domain may look as follows:

https://publications.companyname.com/projectname/pagename


To use your custom domain name, you will have to configure it via the domain settings (settings > domain name > add or edit domain). Usually, your domain provider has a configuration panel that allows you to log in and set-up the configuration. A domain name must be registered with your chosen hosting party in order to create a custom subdomain in Maglr.

Note: make sure to link your Maglr publications to a subdomain (so publications.companyname.com), and not your main domain (companyname.com).

Adjust domain DNS settings



You can adjust the DNS settings via the settings of your domain or hosting provider to ensure that the domain is forwarded to our servers. This referral is done with the help of a CNAME record. If you click on Connect your own domain, the custom DNS record will appear in the green highlighted box. Adjust these DNS record to send the domain to our server.  Ask for help from your colleagues in the IT department to make sure that the settings will be configured correctly.

The domain forward in your settings panel will look something like this:

CNAME -> [yourcode].cname.maglr.com TTL 300


Warning: this is an example! Do NOT copy and paste the code above. Please look up your specific CNAME record through your domain settings in the dashboard.

Image: CNAME record needed to connect a custom domain to your Maglr environment

Note: this configuration can take up to several hours for the settings to be fully implemented.

Note: When making use of Cloudflare, make sure to turn of the Proxy option when adding a DNS record!

Complete the remaining steps



When your domain is configured, there are still two steps left to complete:

Fill in the preferred domain name.
Choose the domain filter. Select the publication(s) you want to be shown on your domain.

What about root / apex domains


You can link a subdomain through any DNS provider using a CNAME record (sub.domain.com or www.domain.com) like explained above.
It works differently for a root or apex domain (domain.com). Many providers only offer the option to to use a A-RECORD. Because Maglr does not support fixed IP addresses, an A-record cannot be used and must be done differently.

Use a CNAME or ANAME.
More and more DNS providers offer CNAME flattening. You can enter a CNAME on a root domain, but in the background they actually create a dynamic A record for you. Cloudflare is a provider that offers this option. Check whether the option for CNAME or ANAME is available in your DNS provider's options.

Create a redirect
Another option is to redirect the root domain to the www variant. You create the subdomain www.domain.com via a CNAME record (the www variant is a subdomain that can always be referred to the Maglr servers via a CNAME reference). What remains is the root variant without WWW. Many DNS providers offer the option to redirect a URL. What you can do is create the following redirect https://domain.com -> redirect -> https://www.domain.com

Updated on: 08/10/2024