> For the complete documentation index, see [llms.txt](https://docs.simptel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.simptel.com/tf-platform/administration/organizations/projects/tenants/domains/configure-custom-domain.md).

# Configure custom domain

This article provides instructions for configuring a custom domain in the TF Platform.

### Steps to Configure a Custom Domain

#### 1. Inside the platform

* Navigate to **Add New Domain**.
* In the dialog, enter the domain name.
* And select your ACME Provider: Lets Encrypt or ZeroSSL
* Click **Save** to generate the required CNAME record for DNS setup.

#### 2. Outside the platform

* Log in to your DNS provider’s management console.
* Add the generated CNAME record to your DNS zone.
* Ensure the TXT value has the ACME generated value with right config.
* Ensure the CNAME value points to the target **subdomain.tfplatform.com**.
* Save the updated DNS configuration.

#### 3. Domain Verification

* Return to the **Domains** page.
* Click **Verify** to confirm the DNS changes.
* When the domain is verified, a success message will indicate this. The status will update to “Verified” under the Domain tab.

{% hint style="info" %}
*The verification process can take up to 5 minutes, and DNS changes may take up to 24 hours to fully propagate.*
{% endhint %}

***

### DNS Configuration Tips and Troubleshooting

**DNS Configuration Tips**

* Ensure the CNAME or A record is accurately entered in your DNS settings.
* Confirm that the domain points to the generated CNAME provided by the TF Platform.

**Verification Issues**

If verification fails, the platform will provide troubleshooting steps. Common issues include:

* **Propagation Delays**: DNS changes may take time to propagate. Wait up to 5 minutes for verification and 48 hours for full propagation before retrying.
* **Incorrect DNS Settings**: Double-check that the records were entered correctly.

For persistent issues, consult your DNS provider’s documentation or our support team for further assistance. Following these steps will help ensure the successful configuration of your custom domain.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.simptel.com/tf-platform/administration/organizations/projects/tenants/domains/configure-custom-domain.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.