Custom domains
Use a custom subdomain for your cloud router endpoint
Cloud Dedicated is currently in invite-only
To interact with your supergraph, clients send requests to your router'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 cloud routers from DDoS attacks
- Provide TLS termination to your cloud routers
How custom domains work
Custom domains use apollographos.net
router endpoint URL. Custom domains run on
Custom domains setup
Setup includes two steps:
- Setting up a CNAME record in your DNS provider.
- Opening a ticket with Apollo support to enable your CNAME.
ⓘ NOTE
Custom domains will be available through self-service in GraphOS Studio 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 variant's api.mydomain.com
that points to current--docs-example.apollographos.net
.
You can find your Dedicated variant's subdomain in
ⓘ NOTE
CNAME records are assigned at the variant level, so you must set up a separate CNAME record for each graph 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,
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
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 recordsorA records
- Multiple custom domains per variant
- Load balancing traffic across multiple variants