Custom Domain Service

The Custom Domain Service maps your domain (for example explorer.yourchain.example) to your OpenScan.AI deployment and keeps TLS certificates issued and renewed — so users reach the explorer on your brand’s domain, not ours.


How It Works

  1. You create a DNS record pointing your domain at the deployment’s ingress address.
  2. The service detects the domain, verifies DNS, and provisions a certificate automatically.
  3. Incoming requests for your domain are routed to your explorer instance with your branding applied.

Setup

  1. Choose the domain — a dedicated subdomain is recommended.
  2. Create the DNS record:
explorer.yourchain.example. CNAME ingress.openscan.ai.

(Self-hosted deployments point at their own reverse proxy instead — see TLS / HTTPS Setup.)

  1. Register the domain in your deployment configuration or with the OpenScan.AI team for hosted instances.
  2. Verify — once DNS propagates, the certificate is issued and https://explorer.yourchain.example serves your explorer.

Behavior and Limits

  • One primary domain per explorer instance; additional aliases can redirect to it.
  • Certificate issuance and renewal are automatic; check the service’s logs if a domain shows certificate errors.
  • DNS changes can take minutes to hours to propagate — plan launches accordingly.

Troubleshooting

SymptomLikely cause
Certificate errorDNS not pointing at the ingress yet, or CAA records blocking issuance
Default branding shownDomain not registered in deployment configuration
Intermittent failuresConflicting A and CNAME records on the same name

For hosted instances, the OpenScan.AI team handles this end-to-end — just tell us the domain via the contact form.