Introduction

When using EvaluationsHub, you can provide your customers or team members with a branded custom subdomain, such as feedback.company.com or www.feedback.company.com, instead of the default company.evaluationshub.co. This setup ensures your portal is aligned with your company’s branding, giving a professional and seamless user experience.

The subdomain on the EvaluationsHub platform (e.g., company.evaluationshub.co) is selected by the admin during the registration process. This guide will show you how to map your custom subdomain to your EvaluationsHub subdomain while keeping your custom URL (e.g., feedback.company.com) visible in the browser.

Step-by-Step Guide

Step 1: Choose Your Subdomain on EvaluationsHub

When you register your company on EvaluationsHub, you are prompted to choose your unique subdomain. For example:

• If you select "company," your portal URL will be company.evaluationshub.co.
• This subdomain will serve as the destination for your custom domain setup.

Note: If you need to change your EvaluationsHub subdomain later, please contact our support team.

Step 2: Choose Your Custom Subdomain

Decide on the subdomain you want to use on your own company’s domain. Examples include:

• feedback.company.com
• www.feedback.company.com

This will be the custom-branded URL your users will see in the browser.

Step 3: Access Your Domain’s DNS Settings

1. Log in to your domain registrar or hosting provider (e.g., GoDaddy, Cloudflare, AWS Route 53).
2. Navigate to the DNS or Zone Management section for your domain.

Step 4: Add a CNAME Record

1. Locate the CNAME Section:
   Look for an option to add a new DNS record.

2. Create a New CNAME Record:

   • Type: CNAME
   • Name/Host: Enter the name of your custom subdomain (e.g., feedback or www.feedback).
   • Value/Target: Enter your EvaluationsHub subdomain (e.g., company.evaluationshub.co).
   • TTL (Time to Live): Leave the default value (e.g., 3600 seconds or 1 hour).

3. Save the Record:
   Once you save, DNS propagation can take a few minutes to a few hours (typically within 1–4 hours).

Step 5: Set Up a Reverse Proxy (to Keep Your Custom Subdomain Visible)

Without additional configuration, visitors to your custom subdomain will be redirected to company.evaluationshub.co, and they’ll see this URL in the browser. To keep your custom subdomain (e.g., feedback.company.com) visible in the browser, you’ll need to configure a reverse proxy on your web server.

Option A: Using NGINX

1. Access Your NGINX Configuration:
   • Log in to your server and edit the configuration file for your custom subdomain (e.g., /etc/nginx/sites-available/feedback.company.com).
2. Add the Reverse Proxy Configuration:

   nginx
   
   server {
       listen 80;
       server_name feedback.company.com;
   
       location / {
           proxy_pass https://company.evaluationshub.co;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
           proxy_set_header X-Forwarded-Proto $scheme;
       }
   }
   

3. Test and Reload NGINX:
   • Test the configuration:

     bash
     
     sudo nginx -t
     

   • Reload the server:

     bash

   • sudo systemctl reload nginx
     

Option B: Using Apache

1. Edit the Apache Configuration:
   • Access the virtual host configuration file for your custom subdomain.
2. Add the Reverse Proxy Configuration:

   apache
   
   <VirtualHost *:80>
       ServerName feedback.company.com
       ProxyPreserveHost On
       ProxyPass / https://company.evaluationshub.co/
       ProxyPassReverse / https://company.evaluationshub.co/
   </VirtualHost>
   

3. Enable Proxy Modules:
   • Run these commands:

     bash
     
     sudo a2enmod proxy
     sudo a2enmod proxy_http
     sudo systemctl restart apache2
     

Step 6: Enable HTTPS (SSL Certificate)

1. Obtain an SSL Certificate:
   • Use a free service like Let's Encrypt or purchase a certificate from your hosting provider.
2. Install the Certificate on Your Server:
   • Follow the instructions provided by your hosting provider to configure HTTPS for your custom subdomain.

Step 7: Test Your Custom Subdomain

1. Open a browser and navigate to feedback.company.com (or www.feedback.company.com).
2. Confirm that your EvaluationsHub portal loads successfully while keeping your custom subdomain visible in the browser.

Frequently Asked Questions (FAQ)

1. How is my EvaluationsHub subdomain chosen?

You select your EvaluationsHub subdomain (e.g., company.evaluationshub.co) during the registration process. This subdomain will act as the base for your portal. If you need to change it later, contact our support team.

2. Why do I need a CNAME record?

The CNAME record ensures that your custom subdomain (feedback.company.com) points to your EvaluationsHub portal (company.evaluationshub.co).

3. Why do I need a reverse proxy?

Without a reverse proxy, users will see company.evaluationshub.co in their browser when they visit your portal. The reverse proxy keeps your custom subdomain visible, maintaining your branding.

4. What if I don’t have access to a web server?

If you don’t manage your own web server, contact your IT team or hosting provider. Alternatively, use a managed DNS service like Cloudflare, which can handle this setup for you.

5. Can EvaluationsHub help with this setup?

Yes! If you’re unsure about any step, feel free to contact our support team. We’ll guide you through the process or coordinate with your IT team.