> For the complete documentation index, see [llms.txt](https://bothosting-net.gitbook.io/bot-hosting.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bothosting-net.gitbook.io/bot-hosting.net/guides/link-a-domain.md).

# Link a Domain

Use the **Domains** tab to connect a hostname to your HTTP server.

You can use either a server-provided subdomain or your own domain.

<figure><img src="/files/fwLsXl0a1pKQPt3sIkqT" alt=""><figcaption></figcaption></figure>

***

### Server-provided subdomains

Click **Activate** to assign a secure subdomain that ends with `.apps.bot-hosting.cloud`.

HTTPS is enabled automatically.

<figure><img src="/files/HLD0fEOJ7biwNKOe6ic3" alt=""><figcaption></figcaption></figure>

If you want a cleaner alias, use the option below **Canonical URL**.

Enter the name you want. If it is available, the panel assigns it to your server.

<figure><img src="/files/wTIDRUqpYTWO9tnxeQvh" alt=""><figcaption></figcaption></figure>

***

### Link a custom domain

You need access to your DNS provider before you start.

Enter the domain or subdomain you want to use, then click **Attach**.

<figure><img src="/files/Sg4B1UkySghNkC2iYncf" alt=""><figcaption></figcaption></figure>

The panel then shows the DNS records required for that hostname.

Add the records exactly as shown, including the record type, name, and target or value.

<figure><img src="/files/pqnK2cjtercFAy899WbL" alt=""><figcaption></figcaption></figure>

Once the records are live, click **Verify**.

DNS changes can take a few minutes to several hours to propagate.

{% hint style="info" %}
Verification usually fails because the record name is wrong, the target or value does not match, or another DNS record conflicts with it.
{% endhint %}


---

# 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 dynamically by asking a question.

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

```
GET https://bothosting-net.gitbook.io/bot-hosting.net/guides/link-a-domain.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.