Skip to main content

Custom domain on a dedicated gateway

Legacy: This page documents Filebase's IPFS tier. For new deployments, use the S3-compatible object storage tier with the s3.filebase.io endpoint.

You can serve a dedicated gateway from a custom domain (e.g. cdn.example.com instead of my-gateway.myfilebase.com). Filebase auto-provisions a Let's Encrypt TLS certificate for the domain.

Add a custom domain​

  1. Open the gateway in the console.
  2. Settings → Custom Domain → Add Domain.
  3. Enter the hostname.
  4. Filebase shows you the CNAME target.
  5. Add a CNAME record at your DNS provider: 
    cdn.example.com.   CNAME   my-gateway.myfilebase.com.
  6. Wait for DNS propagation (usually a few minutes).
  7. Filebase verifies the CNAME and provisions the certificate.

Once issued, the gateway is reachable at https://cdn.example.com/ipfs/{CID}.

Root domains​

For root domains (e.g. example.com), use an ALIAS / ANAME record if your DNS provider supports it. Cloudflare's CNAME flattening, Route 53's alias records, and most modern DNS providers support root-domain CNAMEs.

TLS auto-renewal​

Filebase auto-renews the Let's Encrypt certificate before expiry. As long as the CNAME stays valid, no manual action is required.

What's next​