Whitelabelling
      Back to home
      1. Help Center
      2. Control Portal
      3. Whitelabelling

      Customizing the Control Portal FQDN

      This article will provide a walkthrough on customizing the control portal FQDN with a custom SSL certificate.

      What is a Subdomain vs FQDN?

      A subdomain refers to just the "client" portion of the "client.bvoip.net" address, whereas an FQDN refers to the Fully Qualified Domain Name, or the full "client.bvoip.net" address.

      By customizing the subdomain, you are still using the ".bvoip.net" trail to your portal address, but by customizing the FQDN you can use your full domain such as "portal.client.tld", as well as rebrand the phone system URLs.

      Don't have an SSL?

      This article will walk through updating the FQDN, which requires a third party SSL certificate. If you want to change just the subdomain instead, which doesn't require that, you can review the article below.

      Needed Items for Customizing the Domain with SSL

      • A trusted SSL certification for either a single domain or wild card. 
      • Ownership of the desired domain
      • Access to the DNS of the desired domain

      Creating the SSL

      If you already have an SSL certificate, you can skip to the next section.

      1. Log into the bvoip phone system. 
      2. Go to Settings > Domains on the left-hand side.
        image-png-Jan-31-2024-10-37-48-6396-PM
      3. Scroll down to the Use Your Own Domain section.

      4. Enter your FQDN and company information, then click Ok.
      5. A download will start for key.pem and csr.pem, you may be prompted to allow for multiple downloads.
      6. Use the csr.pem file to order/generate a new SSL certificate according to your vendor's documentation.

      Update FQDN for the Control Portal

      1. Ensure that a CNAME is setup on the desired domain name to point to the address mtp.bvoip.net.
      2. Go to System > Domains again on the left-hand side.
        image-png-Jan-31-2024-10-37-48-6396-PM
      3. In the Custom FQDN field, input the desired domain name.
      4. In the Certificate field, paste the generated Certificate (crt.pem) received from your SSL issuer. This should start with -----BEGIN CERTIFICATE-----.


      5. In the Certification Key field, paste the generated Private Key (key.pem) received from the CSR generator. This should start with -----BEGIN RSA PRIVATE KEY-----.


      6. Click the Setup Custom FQDN button.

      After completing these steps, expect the new domain to be working in full within 15 minutes of being set. 

      Phone System Customization

      If you want to customize the domains that each phone system is using, see our article below for the additional steps necessary for each system.

      • Customizing the Phone System FQDN

      Customized Domain Isn't Taking?

      Reach out to our Support Team if you are seeing that the custom domain is not reflected after applying the change.