# Adding Custom Domains for Web CDN

WARNING

If the target domain is currently active and uses HTTPS, you must import existing SSL certificates into the system before proceeding with DNS modifications described below. This prevents service disruption during the transition.

# Modifying DNS Records

Configure your DNS settings to point your domain to the CDN endpoint by accessing your domain's DNS management system. Update the DNS record to use the hostname provided by ByteArk CDN (e.g., yourteam-idacqn.cdn.byteark.com)

# Example 1 - Using CDN with Main Website (www prefix)

For domains like www.example.com using ByteArk CDN hostname yourteam-idacqn.cdn.byteark.com:

  • Remove existing Record for www or www.example.com
  • Add a CNAME Record:
    • Key: www
    • Value: yourteam-idacqn.cdn.byteark.com. (include trailing dot)

TIP

Currently, ByteArk Web CDN doesn't support apex domains (e.g., example.com without www). Only domains with prefixes like www.example.com are supported.

# Example 2 - Using CDN with Subdomains

For subdomain configurations like subdomain.domain.com:

  • Remove existing Record for subdomain or subdomain.example.com
  • Add a CNAME Record:
    • Key: Your subdomain prefix (e.g., subdomain)
    • Value: yourteam-idacqn.cdn.byteark.com. (include trailing dot)

TIP

DNS propagation typically takes up to 48 hours for complete rollout, depending on users' DNS servers' TTL and cache settings.

However, most users will be routed through the CDN within 1-2 hours.