# DNS Setup (Custom domain name)

If you want borrowers to access Maxwell using a custom link such as:

**apply.yourcompany.com**

Then your company’s IT team needs to add a DNS record that points this custom link to Maxwell’s servers. This does not give Maxwell control of your domain. It simply tells the internet: When someone enters apply.yourcompany.com, send them to Maxwell’s POS.

This document will describe how to setup a DNS CNAME record to white label your Maxwell instance. 

## Subdomain DNS Setup

{% hint style="warning" %}
In the examples below make sure to replace the words `bankname.com` with your actual domain.
{% endhint %}

{% hint style="info" %}
A subdomain is the word before the first dot of the domain, for example `"apply"` in `apply.bankname.com` or `"www"` in `www.himaxwell.com`. 

The web address where your customers will access your site (the Borrower Hub) on the Maxwell platform will be `https://apply.bankname.com`.
{% endhint %}

1. Decide on the desired subdomain.<br>
2. Generate the DNS record:<br>
   1. Log in to the DNS provider portal for your domain (e.g. *GoDaddy*, *NameCheap*, *Google Domains*, *Digital Ocean,* etc.). If you don’t know your DNS provider login information, you may have to contact the person in your organization who maintains your web technology or helped you buy the domain. <br>
   2. Within the DNS provider portal, find a section named similar to "*Managing DNS"*, or "*Managing DNS Zone File"*. <br>
   3. Create a new `CNAME` record with the following values:

      <table data-header-hidden><thead><tr><th width="149">Type</th><th width="199">Host</th><th width="210">Target</th><th>TTL</th></tr></thead><tbody><tr><td><strong>Type</strong></td><td><strong>Host</strong></td><td><strong>Target</strong></td><td><strong>TTL</strong></td></tr><tr><td><code>CNAME</code></td><td>your chosen subdomain<br>(the word <code>apply</code> per the above example)</td><td><code>app.mhsite.loan</code></td><td><code>3600</code></td></tr></tbody></table>
   4. Email <help@himaxwell.com> with your chosen target subdomain (in this example, `apply`).<br>
   5. We will generate an SSL certificate for that subdomain to encrypt all traffic and prevent security warnings. We will also update your Maxwell site so it appears at the target subdomain.\
      &#x20;&#x20;
   6. After you have made the change in step 3, please verify that the changes were successful by using [this NS lookup tool](https://network-tools.com/nslookup/#search=dns-advanced\&search=apply.hmamortgage.com\&target=query_results\&form=ntscform\&base10toip=false\&type=ANY\&typeclass=IN\&port=\&timeout=\&norecurse=undefined\&rawoutput=undefined). See the following screenshots as a reference.

{% hint style="warning" %}
Be aware that the DNS change may take anywhere from a few minutes to 24 hours to propagate throughout the Internet depending on your DNS provider.
{% endhint %}

![1. Type the full domain in the Host field, and choose a CNAME query](https://2622734615-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNeX8nmtEPnFygumL_k%2F-MglmMo36FEBnOS8t6Ha%2F-MglrJMLFZdqf6Br-Fh3%2Fimage.png?alt=media\&token=3e55083c-bd09-489c-b993-3d35b7bda152)