Add a Custom Domain to Your Site

Frappe Cloud lets you use your own domain name instead of the default .frappe.cloud address. You can add both subdomains and root (naked) domains, secure them with HTTPS, and configure redirects to make your preferred domain the primary address for your site.

Step 1: Configure DNS Records

Sign in to your domain provider and create the appropriate DNS record based on the type of domain you want to use.

For a Subdomain

Create a CNAME record that points your subdomain to your Frappe Cloud site.

Example:

• www.example.com → example.frappe.cloud

For a Root (Naked) Domain

Create a single A record that points your domain to your site’s Inbound IP, which is available in your Frappe Cloud dashboard.

• Use only one A record for the domain.
• If your site’s IP changes in the future, update the DNS record accordingly.

If your DNS provider supports CNAME flattening or ALIAS/ANAME records (such as Cloudflare), you can use a CNAME for the root domain instead of an A record.

Step 2: Add the Domain in Frappe Cloud

1. Open your site’s dashboard.
2. Go to the Overview page.
3. Locate the Domains section.
4. Click Add Domain.
5. Enter your custom domain.
6. Click Verify DNS.
7. Once verification succeeds, click Add Domain.

After the domain is added, Frappe Cloud automatically provisions an SSL certificate so your site can be accessed securely over HTTPS.

Set a Primary Domain

If your site has multiple domains, you can choose one as the Primary Domain. Visitors accessing any redirected domains are automatically sent to the primary domain, ensuring a consistent URL.

1. Open the Domains section of your site.
2. Set the preferred domain as the Primary Domain.
3. Enable redirection for any additional domains you want to forward.

Using a primary domain also helps prevent duplicate URLs from appearing in search engine results.

Using Cloudflare or Other WAF Services

You can place services such as Cloudflare in front of your custom domain for features like IP filtering, caching, and bot protection.

• During DNS verification, set the DNS record to DNS Only (disable proxying).
• After the domain has been successfully added, you can enable the proxy again if required.
• Be aware that Cloudflare proxying may affect WebSocket connections, which can impact real-time features.

Search Engine Optimization

If you do not want your site to appear in search engine results, configure your site’s indexing settings appropriately in your website configuration.

If Google displays your site name as Frappe Cloud, it may have indexed the site while it was inactive. Requesting a recrawl after the site is active usually resolves the issue.

Frequently Asked Questions

Can I use both a root domain and a subdomain?

Yes. Frappe Cloud supports both root (naked) domains and subdomains on the same site.

Can I upload my own SSL certificate?

No. Frappe Cloud automatically generates and manages SSL certificates for custom domains.

Which domain appears in outgoing emails and PDFs?

The site’s Primary Domain is used in generated emails and PDF documents.

Can I use a domain purchased from another registrar?

Yes. Domains purchased from providers such as Namecheap, GoDaddy, or Cloudflare can be connected by updating their DNS records.

How can I verify that my DNS changes have propagated?

You can use any public DNS lookup tool to verify that your DNS records have propagated before attempting domain verification in Frappe Cloud.