# Como criar um subdomínio?

## 🌐 O que é um Subdomínio da Discloud?

Na **Discloud**, qualquer app que utiliza uma **porta** e precisa de **acesso externo** através dela para ser acessado é considerada um site. Isso inclui bots com dashboards, dashboards, APIs, sites estáticos e dinâmicos, entre muitos outros…

Para permitir acesso externo ao seu app, a Discloud oferece a opção de criar um **subdomínio personalizado**. Esse subdomínio redireciona o tráfego através do proxy da Discloud para a **porta 8080** do seu app, permitindo que você e os usuários acessem o seu site de forma **segura e confiável**.

### 📡 Como funciona

<figure><img src="/files/sLCrtiCSPScGSuRqsZg3" alt="Discloud subdomain flow"><figcaption></figcaption></figure>

***

## ✅ Requisitos

Para registrar e usar um subdomínio da Discloud, você precisa atender aos seguintes requisitos:

{% hint style="success" %}
[Plano Platinum ou superior](https://discloud.com/plans) é necessário para hospedar sites ou APIs.
{% endhint %}

{% hint style="success" %}
**Porta 8080** – Sua aplicação deve escutar na porta 8080 para receber tráfego externo.
{% endhint %}

{% hint style="success" %}
**Discloud Config** – Seu app deve incluir um arquivo [discloud.config](/configurations/discloud.config.md) devidamente configurado.
{% endhint %}

***

## 🚀 Registre o seu Subdomínio

{% stepper %}
{% step %}
Abra o [Discloud Dashboard](https://discloud.com/dashboard).
{% endstep %}

{% step %}
Clique na aba `Subdomínio` no topo da página da aplicação.

<figure><img src="/files/T41yrbNjj13DX3eYgLI7" alt="Dashboard Subdomain tab"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Clique no botão `+ Subdomínio` para criar um novo subdomínio.

<figure><img src="/files/gw44wZBVa8WFCboTvJIn" alt="Add Subdomain button"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Insira o nome desejado para o subdomínio (ex.: `meuapp`, `dashboard`, `api`).

{% hint style="info" %}

#### **Regras para nomear o subdomínio**

* Máximo de **20 caracteres**
* Apenas caracteres alfanuméricos (A–Z, 0–9) e hífens (-)
* Não são permitidos espaços, underscores ou caracteres especiais
  {% endhint %}
  {% endstep %}

{% step %}
Seu subdomínio agora está registrado e seu estado aparecerá como **Disponível**.
{% endstep %}
{% endstepper %}

***

## 📝 Configure seu [discloud.config](/configurations/discloud.config.md)

Depois que o seu subdomínio estiver registrado, você deve adicioná-lo ao arquivo `discloud.config` para que a Discloud possa direcionar o tráfego para o aplicativo correto.

Abra o arquivo `discloud.config` e localize o campo `ID`:

```ini
ID=seusubdominio
```

{% hint style="warning" %}

#### **Como especificar o subdomínio no arquivo `discloud.config`?**

Use apenas o nome do subdomínio, não o domínio completo (por exemplo, use `meuapp`, e não `meuap.discloud.app`).

Exemplo:

<pre class="language-ini" data-title="discloud.config"><code class="lang-ini"><strong>ID=myapp
</strong>TYPE=site
<a data-footnote-ref href="#user-content-fn-1"># ...</a>
</code></pre>

{% endhint %}

Após atualizar o `discloud.config`, **faça o deploy da sua aplicação** para que as alterações entrem em vigor.

{% content-ref url="/pages/Ag26vcjOXVPlfmI7oBS1" %}
[Como Hospedar, Usando](/how-to-host-using/dashboard.md)
{% endcontent-ref %}

***

## 🔄 Estados do Subdomínio

Seu subdomínio registrado pode ter dois estados:

{% hint style="info" %}

#### **🔵 Ativo**

* O subdomínio está **registrado e em uso**.
* Uma aplicação está atualmente em deploy e acessível em `https://seusubdominio.discloud.app`.
* O tráfego está sendo roteado para a sua aplicação na porta 8080.
  {% endhint %}

{% hint style="info" %}

#### **🟢 Disponível**

* O subdomínio está **registrado e disponível**.
* Nenhuma aplicação está usando ele no momento.
* Você pode fazer o deploy de um app para ativá-lo a qualquer momento.
  {% endhint %}

***

## 🌍 Acesse Seu Site

Quando seu subdomínio estiver **Ativado**, você pode acessá-lo em:

```
https://seusubdominio.discloud.app
```

***

## ⚙️ Domínio Personalizado

Se você quiser usar seu próprio domínio (ex.: `seudominio.com`) em vez de um subdomínio da Discloud, veja:

{% content-ref url="/pages/qjyF7yLyxPtKMXC64Z6w" %}
[Domínio Personalizado](/api-and-integrations/custom-domain.md)
{% endcontent-ref %}

[^1]: **Nota:** Os **`...`** apenas indicam a continuação de outras opções anteriores ou subsequentes que não são relevantes para mencionar nesta página.


---

# 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.discloud.com/faq/general-questions/how-to-create-a-subdomain.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.