Custom domains allow you to publish your CalStudio AI apps on your own branded domain, providing a seamless experience for your users without any CalStudio branding.
Overview
With custom domains, you can:- Host your AI apps on your own domain (e.g.,
chat.yourdomain.com
) - Maintain complete brand consistency
- Build trust with professional URLs
- Improve SEO and discoverability
Prerequisites
Before setting up a custom domain, ensure you have:CalStudio Pro Plan
Custom domains are available on Pro plans and above
Domain Ownership
A registered domain with DNS management access
Setup Process
Step 1: Create and Launch Your App
- Follow the Quickstart Guide to create your AI app
- Configure and test your app thoroughly
- Click “Launch” to make it live
Step 2: Configure Custom Domain
- In your app’s dashboard, locate the Status section
- Click “Publish” → “Custom Domain”
- Enter your desired domain:
- Root domain:
yourdomain.com
- Subdomain:
chat.yourdomain.com
(recommended)
- Root domain:
Step 3: Configure DNS Settings
CalStudio will provide DNS records based on your domain type:For subdomains like
chat.yourdomain.com
:- You’ll receive a CNAME record from CalStudio
- Add this record to your DNS provider:
- Save your DNS changes
Subdomains are easier to configure and don’t affect your main website or email settings.
Step 4: Verify Deployment
- Wait for DNS propagation (usually 5-30 minutes for CNAME, up to 48 hours for NS)
- Visit your custom domain
- Your AI app should now be live!
Use DNS Checker to verify your DNS records have propagated globally.
SSL Certificates
CalStudio automatically provisions and manages SSL certificates for all custom domains using Let’s Encrypt. Your app will be served securely over HTTPS.
Best Practices
Use Subdomains
Subdomains are easier to manage and don’t affect your main website
Test First
Thoroughly test your app before connecting a production domain
Monitor Uptime
Set up monitoring to ensure your custom domain stays accessible
Keep Records
Document your DNS configuration for future reference
Common DNS Providers
Here’s how to add DNS records in popular providers:Cloudflare
Cloudflare
- Log in to Cloudflare dashboard
- Select your domain
- Go to DNS → Records
- Click Add record
- Choose CNAME type and enter CalStudio values
- Ensure proxy status is set to DNS only (gray cloud)
GoDaddy
GoDaddy
- Sign in to GoDaddy Domain Control Center
- Select your domain
- Click DNS → Manage DNS
- Click ADD under records
- Select CNAME type and add CalStudio values
Namecheap
Namecheap
- Sign in to Namecheap
- Go to Domain List → Manage
- Select Advanced DNS
- Click Add New Record
- Choose CNAME and enter CalStudio values
Google Domains
Google Domains
- Sign in to Google Domains
- Click your domain
- Go to DNS → Manage custom records
- Click Create new record
- Add CNAME record with CalStudio values
Troubleshooting
Domain not working after 48 hours
Domain not working after 48 hours
- Verify DNS records are correctly configured
- Check for typos in the domain name
- Ensure no conflicting A or AAAA records exist
- Contact support with your domain details
SSL certificate errors
SSL certificate errors
- CalStudio automatically handles SSL certificates
- If using Cloudflare, ensure proxy is disabled (DNS only)
- Allow up to 24 hours for certificate provisioning
Email stopped working (root domain)
Email stopped working (root domain)
- This occurs with NS delegation
- You’ll need to recreate MX records in CalStudio’s DNS manager
- Consider using a subdomain instead to avoid email issues
Want to remove custom domain
Want to remove custom domain
- Remove the domain in CalStudio dashboard first
- Then update/remove DNS records at your provider
- Your app will revert to the CalStudio subdomain