Skip to main content

Custom Domains

Custom domains let your tenants access their CRM using their own domain name instead of a subdomain. For example, instead of acme.yourplatform.com, Acme Corp could use crm.acmecorp.com. This is a premium feature that adds significant perceived value.

How It Worksโ€‹

  1. You enable Custom Domains for a subscription plan
  2. A tenant on that plan enters their custom domain in their dashboard
  3. The tenant points their domain's DNS to your server
  4. The module automatically detects and routes traffic to the correct tenant

Enabling Custom Domains for a Planโ€‹

  1. Go to SaaS Management โ†’ Plans
  2. Edit the plan where you want to enable custom domains
  3. Scroll down to "Advanced Feature"
  4. Toggle "Enable Custom Domain" to ON
  5. Click Save

Toggle "Enable Custom Domain" in the Advanced Feature section โ€” typically for your premium plans only

info

Business Strategy: Only enable Custom Domains on your higher-tier plans. This creates a powerful incentive for tenants to upgrade. Custom domains have high perceived value โ€” tenants will happily pay more for the ability to use their own domain.

How Tenants Set Up Custom Domainsโ€‹

Once custom domains are enabled for their plan, tenants will see a "Enable Custom Domain" section in their dashboard.

Step 1: Tenant Enters Their Domainโ€‹

Tenants simply type their domain name and click Save

Step 2: Tenant Configures DNSโ€‹

When a tenant clicks the info icon (โ„น๏ธ) next to the Custom Domain section, they see a built-in DNS configuration guide:

A clear, step-by-step DNS guide appears right inside the dashboard โ€” no need to create support documentation!

The guide tells them exactly what to do:

  1. Purchase a domain (if they don't have one)
  2. Access their DNS settings at their registrar
  3. Add an A Record pointing to your server's IP
  4. Optionally add a www version
  5. Wait for DNS propagation (up to 48 hours)

Step 3: Domain Goes Liveโ€‹

Once DNS propagates, the tenant can access their CRM at their custom domain. The module handles all the routing automatically.

Admin View of Custom Domainsโ€‹

As an admin, you can see and manage tenant custom domains:

  1. Go to Customers in your admin panel
  2. Click on the tenant
  3. Look for the "Enable Custom Domain" section

Admin can view and manage custom domains for any tenant

SSL for Custom Domainsโ€‹

Custom domains need their own SSL certificates. Options:

MethodEffortCost
Tenant uses CloudflareNone (tenant handles it)Free
Let's Encrypt (Certbot)Run one command per domainFree
Paid certificateManual installation per domain$10-70/year

The easiest approach is to recommend Cloudflare to your tenants โ€” they get free SSL automatically.

Troubleshooting Custom Domainsโ€‹

IssueCauseFix
Domain shows "not found"DNS hasn't propagatedWait up to 48 hours and try again
Domain shows your hosting default pageWeb server not configured for the domainAdd the domain to your Apache/Nginx config
SSL warningNo SSL certificate for the custom domainSet up SSL using Let's Encrypt or Cloudflare
success

Custom domains configured! Next, set up the API Settings if you need programmatic access to your SaaS platform.