Skip to main content
All CollectionsGetting Started
πŸš€ Publish & Custom Domain
πŸš€ Publish & Custom Domain
Updated over a week ago

You can instantly publish your project to a Dora subdomain or custom domain on the web.

How to publish?

  1. Click Publish in the top bar.

  2. Turn on the switch to the domain you want to publish.

Switches control publishing.

  • Turn on - means your Dora project is published in this domain.

  • Turn off - means unpublished.

Publish to Dora subdomain

You can host on the Dora subdomain (subdomain.dora.run) if you don't have your domain. This domain is free.

You can also use the Dora subdomain as a staging domain for testing and feedback.

Publish to a custom domain

In addition to publishing your site to a Dora subdomain (subdomain.dora.run), you can also publish your project to any custom domain you own (yourdomain.com).

Before you get started with this tutorial, make sure you:

  • Own the domain name you want to connect to your website or buy a domain from a provider of your choice

  • You can update your DNS records with your domain registrar or DNS provider

  • Rest your DNS settings if you've previously hosted your domain elsewhere. It helps minimize and even eliminate issues or conflicts that require troubleshooting DNS settings later.

πŸ“• When the DNS cache expires, it can take up to 48 hours for DNS changes to fully propagate across all geographic locations, although this usually happens within a few hours.

Getting started

You can point your custom domain to Dora and connect it to your Dora project in four steps:

Step 1. Add your custom domain

To add your custom domain to your Dora project:

  1. Click Publish in the top bar.

  2. Click Custom Domain and enter your domain.

πŸ“• Important:

Whether you enter the root domain(yourdomain.com) or the full domain(www.yourdomain.com), we will add both the root and full domains. The default domain is the full domain, so we only show the full domain in the publish dialog.

If you want to connect to a subdomain (subdomain.yourdomain.com), ignore this.

πŸ“• Do not support domains with special characters.

πŸ“• One domain corresponds to one Dora project. If you want to connect the domain to another project, you must first remove the connection from the original project.

Step 2. Update the DNS

  • Configuring a Domain

  • Visit the admin console of your domain registrar (the website you bought your domain from) and create these CNAME Records:

Type

Name

Value

CNAME

@

Tls.dora.run

CNAME

WWW

Tls.dora.run

If you fail to connect, review domain provider instructions for "@" name necessity or delete and create Backup Records:

Type

Name

Value

A

@

76.223.82.128

A

@

13.248.206.240

CNAME

WWW

Tls.dora.run

🌐 Domain Provider

Domain registrars typically have their own custom panel for DNS management.

Listed below is a list of support articles for the most commonly used domain registrars:

Configuring a Subdomain

If you are configuring a custom subdomain (subdomain.yourdomain.com), you can set a CNAME Record in your DNS settings.

Type

Name

Value

CNAME

Subdomain

Tls.dora.run

πŸ“• Make sure to replace the subdomain in the examples above with the actual name of your subdomain.

Step 3. Verify the domain is pointing to Dora

To verify your DNS settings are correct and that your domain is pointing to your Dora site correctly.

  1. Click Publish in the top bar.

  2. Click the pen icon for the custom domain.

  3. Click the Check Status button under your domain.

DNS changes can take a few minutes to propagate β€” or even longer if it's a new domain. If your site verification doesn't work immediately, you can return later to recheck the status. If you still have issues with your domain verification, reach out to your DNS provider to ensure the records are set correctly.

If your DNS settings are correct, but you're still experiencing issues with your published site, please reach out to us and we'll help you resolve any issues.

Step 4: Publish your site to the custom domain

The final step is to publish your website. You should see your new custom domain in the publish dialog.

Turn the switch on and publish.

How to unpublish?

You can switch in the publish dialog to unpublish any or all domains. Unpublished works instantaneously, but you can continuously publish by checking the domain(s) and publishing again.

⚠️ If you unpublish, visitors will see the default 404 page provided by Dora.

How to replace a custom domain?

A Dora project only supports adding one custom domain at the moment. Any edit or replacement of the domain will require deleting the current domain first.

  1. Click Publish in the top bar.

  2. Click the pen icon for the custom domain.

  3. Click the trash icon to delete.

  4. Click Custom Domain and enter the new domain.

Delete the current domain first.

Add the new domain.

Did this answer your question?