Domain Management

Manage custom domains across all tenants from a single dashboard. Configure DNS integrations, monitor SSL provisioning, and troubleshoot domain issues.

Go to Super Admin > Domains.

---

Overview Stats

Six summary cards at the top of the page:

Card	Description
Total	All custom domains across all tenants
Pending	Domains awaiting DNS verification
Verified	DNS verified, awaiting SSL provisioning
Active	Fully working with SSL
Failed	Provisioning failed — requires attention
Fallback	Automated provisioning failed, using manual mode

---

Domain List

The domain list shows all custom domains across your platform:

• Domain name - The custom domain
• Tenant name - Which tenant owns the domain
• DNS status - Current DNS verification state
• SSL status - Current SSL certificate state
• Integration mode - Manual, cPanel, or Cloudflare
• Primary badge - Indicates the tenant's primary domain
• Fallback badge - Indicates domains using fallback mode

Filtering

• Search by domain name or tenant name
• Filter by DNS status (Pending, Verified, Failed, etc.)
• Filter by integration mode (Manual, cPanel, Cloudflare)

---

Domain Detail

Click any domain to view its full detail page:

DNS Details

• DNS status
• Last checked timestamp
• Check count
• Required DNS records (what the tenant needs to add)

SSL Details

• SSL status
• Provisioned date
• Expiry date

Error Messages

Any errors encountered during DNS verification or SSL provisioning are displayed here with timestamps.

---

Domain Actions

Action	What It Does
Verify DNS	Manually trigger a DNS verification check
Check SSL	Check the current SSL certificate status
Make Primary	Set this domain as the tenant's primary domain
Retry Integration	Retry the full integration process
Reprovision	Start the provisioning process from scratch
Retry SSL	Retry SSL certificate provisioning
Delete	Remove the domain entirely

---

Domain Settings

Go to Super Admin > Domains > Settings to configure domain provisioning.

Global Settings

• Server IP - The IP address pointed to by A records
• Max Domains per Tenant - Limit how many custom domains each tenant can add
• Fallback Timeout - How long to wait before switching to fallback mode

Integration Mode

Choose how domains are provisioned on your server:

Manual

• No automation — tenants receive DNS instructions and configure manually
• Simplest setup, works with any hosting

cPanel

• Automated domain provisioning via cPanel API
• Required settings: Hostname, Username, API Token, Document Root
• Domains are automatically added to your cPanel configuration

Cloudflare

• Automated domain provisioning via Cloudflare API
• Required settings: API Token, Zone ID, CNAME Target
• DNS records are automatically created in Cloudflare

Testing & Detection

• Test Connection - Verify your integration credentials work correctly
• Redetect Hosting Panel - Auto-detect available hosting panel integrations

---

Domain Pipeline

A cron job automates the domain provisioning pipeline:

• Every 5 minutes - DNS checks for pending domains
• Every 15 minutes - Full provisioning cycle for verified domains
• Daily - SSL expiry check across all active domains

Domain Event Log

Each domain maintains an audit trail showing:

• All provisioning attempts
• Status changes
• Error details
• Timestamps for every event

Use the event log to diagnose issues and understand the full history of a domain's provisioning process.

---

Next Steps

• Platform Announcements - Communicate with your tenants