This guide will walk you through the process of setting up a custom domain for your project's edge deployment environment. You can manage all domain settings related to a project in the Custom Domains section of the Settings tab of your project. Custom Domains are available on Builder plans and above.
Custom domains can only be added to edge deployed environments. You can tell if
an environment is edge deployed if the domain ends with
Environments with domains ending with
zuplo.dev are for development only and
do not support custom domains.
Adding a new custom domain#
The following steps will guide you on how to add and configure a custom domain for your Zuplo project.
1. Navigate to your project's Custom Domain Settings#
Go to your project in the Zuplo portal and open to the
Settings tab (1), then select Custom Domain (2) and click on the
Add New Custom Domain button to open the
New Custom Domain configuration
2. Add your domain#
Then, pick the edge deployed environment you want to assign the domain to and enter your apex domain (e.g. example.com) or subdomain (e.g. api.example.com)
Once saved, you will be provided with a
CNAME configuration that will look
something like the one below that you'll use in the next step.
3. Configure your DNS#
Once you have added your custom domain to your Zuplo project, you will need to configure the DNS records of your domain with your registrar.
Using the CNAME configuration provided at the end of the previous step, you will create that record on your DNS registrar. Cloudflare will then query your domain periodically until it can verify everything. If everything is configured correctly, it should take a few minutes for your production Zup to start responding to traffic on your custom domain. On the other hand, if a misconfiguration (typo) occurs and you need to make changes, Cloudflare could take up to 4 hours to retry the verification. Please be patient if this happens.
By default, you can also use the url on
zuploapp.com although, if you prefer
that to be removed contact support and we can disable it for you.
If you use Cloudflare as your DNS provider, you MUST enable Cloudflare Proxy on your custom domain.
Some changes, like the domain set in your developer portal, only get picked up on the deployment. After you set a custom domain it is a good idea to redeploy your environment to ensure everything is applied correctly.
Zuplo uses Cloudflare for routing custom domain traffic to our servers. If you use Cloudflare on your domain, there are a few limitations to be aware of. In general, these shouldn't be a problem as we handle all the complexities for you.
For host names managed by Zuplo, you cannot control some Cloudflare settings for
your Zuplo subdomain (i.e.
api.example.com). Examples include:
- Wildcard DNS
- Page Shield
See Cloudflare's documentation for more details.
Other Cloudflare features that are configured on your Cloudflare Account such as Firewall or WAF rules will function normally.
At this time, to use a wildcard domain or other complex custom domain for your environment you will need to contact firstname.lastname@example.org.
Vercel DNS Customers#
If you are using Vercel DNS, you may encounter an issue with the SSL certificate created with your domain name. If this happens, please contact email@example.com and mention that you are using Vercel DNS.