π Custom Domains
Set up a custom domain for your Pine AI whitelabel chat application
Custom Domains
Host your Pine AI chat application on your own domain (e.g., chat.yoursite.com) instead of the default {slug}.pine-sports.com URL.
Setup Steps
1. Add Your Domain in the Dashboard
Navigate to the Pine AI settings in your SharpSports dashboard and add your custom domain in the Domains section.
2. Create a CNAME Record
In your DNS provider, create a CNAME record pointing your domain to the target shown in the dashboard.
| Record Type | Host | Value |
|---|---|---|
| CNAME | chat (or your subdomain) | (target shown in dashboard) |
For a bare domain (e.g., yoursite.com without a subdomain), some DNS providers require an ALIAS or ANAME record instead of CNAME. Check your provider's documentation.
3. Wait for DNS Propagation
DNS changes typically take 5β30 minutes to propagate, though in rare cases it can take up to 48 hours.
4. Configure SSL
You are responsible for provisioning SSL/TLS certificates for your custom domain. Ensure your domain is served over HTTPS before going live β your users will need a secure connection to authenticate and use the chat application.
5. Auth Callback URLs Are Auto-Generated
When you add a custom domain, the following OAuth callback URLs are automatically registered with your Auth0 organization:
https://yourdomain.com/callback
Custom callback URLs for non-whitelabeled domains (e.g., a subscribe page) can be added manually in the dashboard under Custom Callback URLs.
Using Multiple Domains
You can add multiple custom domains to the same whitelabel configuration. Each domain will serve the same branded chat application with the same theme, features, and user base.
Troubleshooting
Domain not resolving
- Verify your CNAME record is set correctly with your DNS provider
- Allow up to 30 minutes for propagation
- Use
dig yourdomain.com CNAMEor an online DNS checker to verify the record
www vs bare domain
- For
www.yoursite.com, create a CNAME on thewwwsubdomain - For
yoursite.com(bare domain), use an ALIAS or ANAME record if your DNS provider supports it - We recommend using a subdomain like
chat.yoursite.comfor the simplest setup
SSL certificate issues
- Ensure your SSL certificate covers the exact domain you added (including
wwwif applicable) - If using a CDN or reverse proxy, configure SSL termination there
Updated about 2 hours ago