cPanel DNS settings for Wildcard Subdomain + SSL Support
The cPanel integration enables automated DNS management for your SaaS tenants using wildcard subdomains (e.g., *.yourcrm.com). This setup simplifies tenant provisioning by eliminating the need to manually configure DNS records for every new tenant.
β
Prerequisites
Ensure the following before proceeding:
Your domain (e.g.,
yourcrm.com) is added and hosted on a cPanel account.You have access to WHM (or full cPanel DNS and SSL management permissions).
A wildcard SSL certificate (Letβs Encrypt, AutoSSL, or custom) is installed or ready to install.
The domainβs DNS is managed via cPanel or your DNS provider (e.g., Cloudflare).
π Step 1: Add Wildcard DNS Record
Option 1: DNS Managed by cPanel (Zone Editor)
Log in to cPanel.
Navigate to: Domains β Zone Editor.
Click Manage next to
yourcrm.com.Click Add Record and enter:
Type: A
Name:
*.yourcrm.com(or just*depending on interface)Address:
<Your Server IP>
Click Save Record.
Option 2: External DNS Provider (e.g., Cloudflare)
Log in to your DNS providerβs dashboard.
Add an A record with:
Type: A
Name:
*or*.yourcrm.comValue:
<Your Server IP>TTL: Auto or 300
π Step 2: Create Wildcard Subdomain in cPanel
Log in to cPanel.
Go to Domains β Subdomains.
Under Create a Subdomain:
Subdomain: Enter
*Domain: Select
yourcrm.comDocument Root: (e.g.,
public_html)
Click Create.
π If cPanel doesnβt allow * as a subdomain:
You must manually edit Apache configs via WHM or root shell (advanced).
Or request hosting provider support to enable wildcard subdomains.
π Step 3: Install Wildcard SSL Certificate
Wildcard certificates require DNS-01 challenge verification.
Option A: AutoSSL (WHM or cPanel)
Navigate to SSL/TLS β Manage SSL Sites.
Check if AutoSSL has installed a wildcard certificate:
If not, go to SSL/TLS β Let's Encrypt or AutoSSL panel in WHM.
Enable:
β Secure wildcard domain via DNS-01.
If needed, add the required TXT record in your DNS zone.
Run AutoSSL again or complete manual verification.
Once verified, install the wildcard certificate.
β
Youβre Done!
Your cPanel server is now configured to handle wildcard subdomains and SSL for SaaS tenants under *.yourcrm.com.
Last updated