# Configure custom domain

### 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: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.