Custom Domains

Route production client traffic through your own brand name (e.g. api.yourcompany.com) instead of the default EdgeWrap subdomain.

Setting Up a Custom Domain

By default, your project receives a default domain like <your-project>.edgewrap.pro. To configure a custom domain, you need to add it to your project configuration and configure a CNAME record with your DNS provider.

1. Configure your DNS

Go to your DNS provider (e.g., Cloudflare, Route53, Namecheap) and create a CNAME record pointing to our global edge ingress:

Type	Host	Value	TTL
CNAME	api	ingress.edgewrap.pro	Auto / 300s

2. Register via CLI or API

Register the domain under your project. This triggers our edge servers to verify your DNS and automatically provision an SSL/TLS certificate via Let's Encrypt.

Add a custom domain to a project

curl -X POST https://server.edgewrap.pro/v1/projects/prj_01jxyz/domains \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "api.yourcompany.com" }'

Domain Verification & SSL

Once the domain is registered, EdgeWrap continuously checks the CNAME status. Once detected, the SSL certificate is requested. This process usually completes within 1–2 minutes.

Tip: If you are moving an active API to EdgeWrap, you can provision the certificate before swapping your DNS traffic using DNS-01 verification. Contact support for Enterprise custom domain pre-validation.

Limits

Free plans allow 1 custom domain per project. Starter allows up to 5, Pro allows 20, and Enterprise supports unlimited custom domains.