Setting Up Custom Hostnames

Use your own domain for webmail access and mail server connections instead of the default server hostname.

Why Use Custom Hostnames?

Custom hostnames provide several benefits:

• Professional appearance when users access webmail
• Consistent branding across all email services
• Simpler email client configuration for your users

Available Custom Hostnames

You can set up SSL certificates for these subdomains:

Subdomain	Purpose
mail.yourdomain.com	Use in email client settings (IMAP/SMTP)
webmail.yourdomain.com	Access Roundcube webmail interface

Step 1: Find Your Server Name

1. Log into the Management Panel at management.mxroute.com
2. Click "Login to Panel" on your service
3. Go to "DNS" - your server name is shown in the MX records (e.g., fusion.mxrouting.net)

Step 2: Configure DNS Records

Add CNAME records at your DNS provider pointing your chosen subdomains to your server name:

Type	Name	Value
CNAME	mail	(your server name)
CNAME	webmail	(your server name)

IMPORTANT

Use CNAME records, not A records. Server IP addresses may change, but CNAME records will always point to the correct server.

Step 3: Request SSL Certificates

1. In the Control Panel, go to "SSL Certificates"
2. Select your domain from the dropdown
3. The page will automatically check if your DNS records are correctly configured
4. Check the subdomains you want certificates for
5. Click "Request Certificate"

The Control Panel verifies your DNS configuration before requesting certificates from Let's Encrypt. If DNS isn't configured correctly, you'll see an error message explaining what needs to be fixed.

TIP

You can request certificates for one or both subdomains at once. Only select subdomains that have DNS properly configured.

Step 4: Using Your Custom Hostnames

Once certificates are installed:

Email Client Configuration

Configure email clients with mail.yourdomain.com as both the incoming (IMAP) and outgoing (SMTP) server.

Webmail Access

Access Roundcube webmail at https://webmail.yourdomain.com

Troubleshooting

DNS check shows "fail":

• Verify your CNAME record is correctly configured at your DNS provider
• Wait for DNS propagation (can take up to 24 hours, usually much faster)
• Ensure you're using CNAME, not A records

Certificate request fails:

• The DNS checker must show "pass" before certificates can be requested
• Check for CAA DNS records that might block Let's Encrypt
• If you've requested many certificates recently, you may have hit Let's Encrypt rate limits

SSL warning in browser:

• Certificate may still be processing - wait a few minutes and refresh
• Verify you're using https:// not http://