Join us from October 8-10 in New York City to learn the latest tips, trends, and news about GraphQL federation and API platform engineering.Join us for GraphQL Summit 2024 in NYC
Docs
Start for Free

Custom Domains

Use a custom subdomain for your cloud router endpoint


Cloud is currently in invite-only preview. Don't hesitate to get in touch if you'd like to request access or have any questions or feedback.

To interact with your , clients send requests to your 's endpoint. The custom domains feature lets you replace the default apollographos.net router endpoint URL with your own subdomain.

Custom domains can help to:

  • Minimize client-side changes
  • Use your existing CORS policies and security controls
  • Protect your from DDoS attacks
  • Provide TLS termination to your s

How custom domains work

Custom domains use CNAME records to point requests made to your subdomain to your apollographos.net router endpoint URL. Custom domains run on Cloudflare's global network.

Custom domains setup

Setup includes two steps:

  1. Setting up a CNAME record in your DNS provider.
  2. Opening a ticket with Apollo support to enable your CNAME.

NOTE

Custom domains will be available through self-service in later in 2024. In the meantime, you must open a support request to enable your CNAME with Apollo.

Setup a CNAME

Create a CNAME record in your DNS provider that points to your Dedicated 's existing subdomain. For example, create a CNAME for api.mydomain.com that points to current--docs-example.apollographos.net.

You can find your Dedicated variant's subdomain in GraphOS Studio on the Cloud Router page under API Endpoint.

A cloud router's endpoint displayed on the Cloud Router page in GraphOS Studio

NOTE

CNAME records are assigned at the variant level, so you must set up a separate CNAME record for each variant that requires a custom domain.

Using an existing CNAME

If you already have a CNAME record for the custom domain you want to use, contact Apollo Support before making any changes. We'll guide you through remapping from a different host to the subdomain.

Open a support ticket

Next, open a support ticket requesting Apollo to enable your new CNAME. You can open a ticket by clicking the ? icon in the top right of GraphOS Studio and selecting Contact Support.

Requesting a new CNAME in GraphOS Studio

Your request may take up to two business days to process. Apollo will notify you when your new CNAME is live.

Limitations

The custom domains feature doesn't support the following:

  • Apex records or A records
  • Multiple custom domains per variant
  • Load balancing traffic across multiple variants
Previous
Throughput Guide
Next
Migrate to Dedicated
Rate articleRateEdit on GitHubEditForumsDiscord

© 2024 Apollo Graph Inc.

Privacy Policy

Company