🌐 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 TypeHostValue
CNAMEchat (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 CNAME or an online DNS checker to verify the record

www vs bare domain

  • For www.yoursite.com, create a CNAME on the www subdomain
  • 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.com for the simplest setup

SSL certificate issues

  • Ensure your SSL certificate covers the exact domain you added (including www if applicable)
  • If using a CDN or reverse proxy, configure SSL termination there