All of our services support custom domains and they all work similarly. The way it works is you create two DNS records:

1. A CNAME record to send the traffic to us (or an A/AAAA if you don't have CNAME flattening)
2. A corresponding TXT record which we check to determine what content to serve the user.

The first time we receive traffic on the custom domain, a certificate will be retrieved from Let's Encrypt to enable HTTPS.

My DNS does not support CNAME flattening #

Some DNS providers do not support CNAME flattening, which means they don't allow you to create a CNAME record for your apex domain, like "example.com".

If you want to use an apex domain without CNAME flattening, you need to get the IP addresses of the service you want to point to and then use them in an A record (for IPv4) and an AAAA record (for IPv6). You can find the current IP addresses by running host pgs.sh.

WARNING: We make no guarantees that our IP addresses will stay the same. Use at your own risk!

subdomain.yourcustomdomain.com.         300     IN      A       129.158.37.104.
_pgs.subdomain.yourcustomdomain.com.    300     IN      TXT     "{user}-{project}"

Can I use an ALIAS record instead of CNAME? #

Yes, it should work the exact same way.

subdomain.yourcustomdomain.com.         300     IN      ALIAS   pgs.sh.
_pgs.subdomain.yourcustomdomain.com.    300     IN      TXT     "{user}-{project}"