Skip to main content

​
Overview

Mocha supports custom domains, allowing you to deploy your Mocha applications to your own domain. This feature gives you complete control over your website’s URL and branding.

​
Domain Limits by Plan

  • 🥉 Bronze: 1 custom domain
  • 🥈 Silver: 5 custom domains
  • 🥇 Gold: 20 custom domains
These limits are subject to change as we continue to evolve our offerings.

​
How to Set Up Your Custom Domain

1

Purchase a Domain

Buy a domain directly in Mocha or from your preferred domain registrar (e.g., Namecheap, GoDaddy, Squarespace Domains)
You cannot use *.mocha.app subdomains as custom domains. These are reserved for Mocha’s built-in hosting. Use a domain you own from an external registrar instead.
2

Access Domain Settings

In your Mocha project settings, navigate to the “Domains” section
3

Link Your Domain

Enter your domain name and follow the verification process. This will link your domain to your Mocha account.
This can take a while, up to 48 hours depending on the domain provider.
4

Associate the Domain with a Mocha Project

Select the project you want to associate the domain with.
Custom domain setup process

Custom domain setup

5

Publish your Project

Once the domain is connected, you can simply publish as usual, and your Mocha app will be live at your custom domain.

​
Troubleshooting

DNS changes can take up to 48 hours to propagate, though it typically happens within 1-2 hours. Here’s what to check:If your domain stays “stuck” in the pending state. We recommend simply “Deleting” it in Mocha and connecting it again. The process can be flakey and fails sometimes, but typically will work the second time.We apologize for the inconvenience. and are working on improving the process.
SSL certificates are provisioned automatically when you connect a domain, but they can take a few minutes to activate. If you’re seeing certificate errors:
  1. Wait 10-15 minutes after connecting your domain for the SSL certificate to be issued
  2. Try a different browser or try an incognito/private window
  3. Clear your browser cache or try an incognito/private window
If you recently changed DNS providers or settings, you may need to wait for the changes to propagate before SSL works correctly.
To remove a custom domain from your project:
  1. Go to your project settings
  2. Navigate to the “Domains” section
  3. Find the domain you want to remove
  4. Click the remove/disconnect option
After removing, your app will still be accessible via its .mocha.app subdomain (if you have one set up).
To unpublish your app and take it offline:
  1. Click the publish button to open the publish modal
  2. Toggle the selector from “Published” to “Unpublished”
Once unpublished, your app will no longer be accessible to visitors. You can republish at any time.
Mocha currently only supports the exact domain you connect — www subdomains are not automatically configured. For example, if you connect mydomain.com, then www.mydomain.com will not work and will show a Cloudflare Error 1001.This is a known limitation we’re actively working to fix. In the meantime, here’s a workaround:
  1. Set up domain forwarding at your registrar — most registrars (GoDaddy, Namecheap, etc.) offer a “Forwarding” or “Redirect” option in their domain settings
  2. Forward www.mydomain.com → mydomain.com using a 301 (permanent) redirect
  3. This ensures visitors who type www.mydomain.com are automatically sent to your working domain
Do not add a CNAME record pointing www to *.mocha.app — this will not work because the www hostname is not registered in our infrastructure. Use your registrar’s forwarding/redirect feature instead.
If your domain suddenly stopped working:
  1. Check if your subscription is active - Custom domains require a paid plan
  2. Verify DNS settings haven’t changed - Sometimes DNS providers reset settings
  3. Check domain expiration - Make sure your domain registration hasn’t expired
If everything looks correct, contact support@getmocha.com for help.
If you’re having trouble connecting your domain and the above doesn’t help, reach out to support@getmocha.com with your domain name and a screenshot of your DNS settings.

​
Managing Multiple Domains

For users on Silver and Gold plans, you can manage multiple domains:
  • Add new domains at any time
  • Remove domains from your project
  • Monitor domain status
  • Configure domain-specific settings
Need more domains? Consider upgrading your subscription to get access to more custom domains.

​
Purchase Domains Through Mocha

We’ve partnered with IONOS, a leading domain registrar, to offer seamless domain purchases directly within Mocha. This integration allows you to search, purchase, and manage your domains all in one place.
Buy domains in Mocha

Access the domain purchase modal from your project settings

​
Benefits of Buying Through Mocha

  • Streamlined Process: Search and purchase domains without leaving Mocha
  • Instant Setup: Domains purchased through Mocha are automatically linked to your account
  • Competitive Pricing: Access to IONOS’s competitive domain pricing
  • Easy Management: Manage all your domains in one place
After purchasing a domain through Mocha, you can follow the regular domain linking process to associate it with your project.
Buying through Mocha is the fastest way to get started with a custom domain, but you can also purchase or use domains from other registrars.