DNS and domains

See which DNS records a site needs and let pfcloud create the missing ones.

When to use this

A new site needs its domain to point at the server. Reads need dns:read, creating records needs dns:write.

See what is needed

curl -s -H "Authorization: Bearer $TOKEN" $MYFORGE/sites/SITE_ID/dns

The answer tells you which records the site needs and where the domain's DNS is hosted. Other helpers:

• GET /dns/zones: domains pfcloud can manage through the team's DNS connections.
• GET /dns/suggestions: free subdomains you could use for a new site.

Create the missing records

curl -s -X POST $MYFORGE/sites/SITE_ID/dns \
  -H "Authorization: Bearer $TOKEN" -H "Idempotency-Key: dns-shop-1"

pfcloud adds the missing A records through the team's DNS connection (set in team settings, DNS). It never changes a record that points somewhere else. The answer lists what was created, what was skipped (pointing elsewhere) and the names you must change by hand. HTTPS follows a few minutes later.

No DNS connection?

Create the A records at your DNS host by hand (the site's DNS answer shows the server address). pfcloud notices when the name resolves to the server.

What can go wrong