How to add a custom domain

Note: Custom Domains is a DashboardFox Cloud feature and is not available for on-premise or self-hosted installations.

You can configure a custom domain for your DashboardFox workspace so that users access it at your own URL instead of the default DashboardFox address. This article covers how to add, configure, and manage custom domains from within the application.

To access Custom Domains, click Settings in the sidebar, select Server Settings, then click the Custom Domains tab.

Note: Custom Domains is only visible to workspace admins. If you do not see it, contact your administrator to have your access level updated.

How Custom Domains Work

When you add a custom domain, DashboardFox provisions routing and SSL for that domain automatically. You do not need to manage certificates — they are issued and renewed by the system once your DNS is configured correctly.

The process has two stages:

You add the domain — DashboardFox registers it and gives you two DNS records to configure at your DNS provider.
You configure DNS — Once both records are in place, the system detects them automatically, configures routing, and issues an SSL certificate. Your domain goes live without any further action on your part.

Plan Limits

The number of custom domains you can add depends on your subscription plan. Your current usage and limit are shown at the top of the Custom Domains tab. If you have reached your limit, you must delete an existing domain or upgrade your plan before adding a new one.

Adding a Custom Domain

On the Custom Domains tab, enter your domain in the Domain Name field. Subdomains are recommended (for example, app.yourcompany.com).
Click Add Domain.

The domain is added immediately with a status of Pending DNS. You will see two CNAME records appear — these need to be configured at your DNS provider before the domain will go live.

Note: You cannot add a domain that ends in .dashboardfox.app or .yurbi.app. You also cannot add a domain that is already in use by another workspace.

Configuring Your DNS Records

After adding a domain, expand it in the list to see the two CNAME records you need to create at your DNS provider (GoDaddy, Namecheap, Cloudflare, etc.).

Record 1 — Main Domain

This record routes traffic from your custom domain to your workspace.

Field	Value
Type	CNAME
Host / Name	Your full domain (e.g. `app.yourcompany.com`)
Points To / Value	Provided in the DNS setup panel

Tip: Some DNS providers only want the subdomain portion in the Host field. For example, if your domain is app.yourcompany.com, enter just app. Check your provider's documentation if you are unsure.

Record 2 — SSL Certificate

This record enables HTTPS by delegating the SSL challenge to DashboardFox.

Field	Value
Type	CNAME
Host / Name	Provided in the DNS setup panel (begins with `_acme-challenge`)
Points To / Value	Provided in the DNS setup panel

Both records must be in place for your domain to go live. If only the main record is configured, DNS will be detected but SSL provisioning will not start.

Use the copy button next to each value to avoid transcription errors.

Domain Status

Each domain in the list shows a status badge reflecting where it is in the provisioning process.

Status	Meaning
Pending DNS	Waiting for your DNS records to be detected
Active	DNS verified and SSL certificate issued — domain is live
Failed	DNS was never configured and the domain has expired — see below

DNS changes typically propagate within 5–60 minutes. The system checks automatically every few minutes — you do not need to do anything once your records are in place.

Refreshing Status Manually

If you have just configured your DNS records and want to check whether they have propagated, click Refresh Status in the top right of the Custom Domains tab. This reflects the current state as detected by the system.

Stale Domains

If a domain is added but DNS is never configured, it will be marked as Failed after 7 days. This frees up the domain name to be added again. If you still want to use the domain, delete the failed record and re-add it.

Deleting a Custom Domain

Click the delete icon on the domain row you want to remove.
In the confirmation dialog, type DELETE and click Delete Domain.

Deletion removes the domain, its routing configuration, and its SSL certificate. This cannot be undone. The domain name becomes available to be added again once the deletion is processed.

Troubleshooting

My domain has been Pending DNS for more than an hour. Verify that both CNAME records are saved correctly at your DNS provider. Expand the domain row and use the copy buttons to check the values against what you configured. Some providers add the root domain automatically to the Host field — if your record shows app.yourcompany.com.yourcompany.com, remove the root portion and save just app.

My domain shows Active but the SSL certificate shows a warning in the browser. SSL certificates can take a few minutes to propagate through CDN and browser caches after issuance. Wait a few minutes and try a hard refresh.

I see a validation error message on my domain. Expand the domain row to read the specific error. It will indicate whether the main CNAME, the SSL CNAME, or both are missing or pointing to the wrong value.

Managing Your Subscription