Docs / Networking

Custom domains

Available

Apply your own domain names to Isoward web services and static sites. Your service keeps its default {serviceId}.isoward.com URL in addition to any custom domains you add.

Overview

  • Default service URLs use platform TLS (Cloudflare Universal SSL on *.isoward.com).
  • Custom domains: DNS verify + routing always; platform certificates when Cloudflare for SaaS is configured on the operator account (free for the first 100 hostnames).
  • Routing activates after DNS verification: no redeploy required.

1. Add your domain in the dashboard

  1. Open your service → Settings → Custom domains.
  2. Enter your domain (e.g. app.example.com) and click Add domain.

Unicode domains must be Punycode-encoded first (e.g. ëxample.com → xn--xample-ova.com).

2. Configure DNS

Remove AAAA records while configuring DNS to avoid IPv6 routing issues.

  • Subdomains: CNAME to your service default host (e.g. srv-abc123.isoward.com)
  • Apex: ANAME, ALIAS, or CNAME flattening where supported

Provider guides:

3. Verify

  1. Click Verify in Settings → Custom domains.
  2. Use dig CNAME your.domain +short if verification fails: DNS may still be propagating.

TLS for custom domains

With operator Cloudflare for SaaS configured, certificate status appears next to each domain (pending / active). Without it, terminate TLS at your DNS/CDN — Cloudflare SSL mode Full (not Full Strict) when proxying. See TLS certificates.

Advanced

OAuth: register callback URLs for each custom domain. Wildcards: add individual subdomains in v1: wildcard custom domains are not fully supported.