Custom Domain Setup

Connect a domain you own — apex or subdomain.

Ploy supports custom domains for all published sites. You can connect an apex domain (e.g. yourdomain.com) or a subdomain (e.g. docs.yourdomain.com). Ploy handles SSL certificate provisioning automatically.

Quick Setup (Automatic)

Ploy integrates with Entri for one-click domain setup. If your registrar supports it, you can connect your domain without manually editing DNS records.

  1. Go to Settings → Custom Domains in the Ploy dashboard.
  2. Click Add Domain and enter your domain.
  3. Choose Automatic Setup and follow the Entri flow.
  4. Ploy will configure DNS and provision SSL automatically.

Manual DNS Setup

If automatic setup isn't available for your registrar, configure DNS manually:

For Apex Domains (yourdomain.com)

Add the following DNS records at your registrar:

TypeNameValue
A@Provided by Ploy (check your dashboard)
AAAA@Provided by Ploy (check your dashboard)

For Subdomains (docs.yourdomain.com)

TypeNameValue
CNAMEdocsProvided by Ploy (check your dashboard)

Registrar-Specific Guides

DNS configuration varies by registrar. Here are quick links for common providers:

  • Cloudflare — Set DNS records in the Cloudflare dashboard. Make sure to set proxy status to "DNS only" (gray cloud) initially.
  • GoDaddy — Add records in the DNS Management section of your domain settings.
  • Namecheap — Navigate to Advanced DNS in your domain management panel.
  • Route 53 (AWS) — Create a new record set in the hosted zone for your domain.
  • Porkbun — Edit DNS records from the domain management page.

SSL Certificates

SSL certificates are provisioned automatically after DNS verification. This typically takes a few minutes but can take up to 24 hours for DNS propagation.

Tip: If SSL isn't issuing, make sure your DNS records are correct and have propagated. You can check propagation status with tools like dig or online DNS lookup tools.

Troubleshooting

  • DNS stuck on "Pending" — DNS propagation can take up to 48 hours. Verify your records are correct and wait.
  • SSL not issuing — Ensure DNS records point to Ploy's servers (not another host). If using Cloudflare, set proxy status to "DNS only."
  • Redirect loops — If using Cloudflare with "Flexible" SSL mode, switch to "Full (strict)" or "DNS only" proxy mode.
  • "Too many redirects" error — Disable any redirect rules at your registrar/CDN that conflict with Ploy's hosting.

What's Next?