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.com
Value:
<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.com
Document 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