> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Domínios personalizados pela CLI

> Conecte um domínio próprio a um site da Square Cloud, veja os registros DNS que você precisa criar e liste todos os domínios e domínios compartilhados da conta.

Um domínio personalizado leva dois passos: vincule-o à aplicação com `app network domain` e depois crie, no seu provedor de DNS, os registros que o `app network dns` imprime. A central de ajuda tem um [passo a passo de domínio personalizado](https://help.squarecloud.app/pt-br/article/como-configurar-seu-proprio-dominio-cnamedns-j39hh2/) e explica [por que um domínio pode demorar para propagar](https://help.squarecloud.app/pt-br/article/por-que-meu-dominio-ainda-nao-propagou-dns-3ggus4/).

`[appID]` e `--app` são opcionais: veja [como a CLI encontra sua aplicação](/pt-br/cli-reference/quickstart#como-a-cli-encontra-sua-aplicação).

## `squarecloud app network domain`

```bash Uso theme={"system"}
squarecloud app network domain <hostname> [--app <appID>]
```

Define o domínio personalizado da aplicação, substituindo o anterior. Domínios personalizados estão disponíveis nos planos Standard, Pro e Enterprise. Para remover o domínio personalizado, passe `@` como hostname.

```bash theme={"system"}
squarecloud app network domain www.example.com
```

```bash Saída theme={"system"}
✓ Custom domain www.example.com configured successfully
Run 'squarecloud app network dns' to see the DNS records you need to create.
```

## `squarecloud app network dns`

```bash Uso theme={"system"}
squarecloud app network dns [appID] [--json]
```

Imprime os registros DNS a criar para o domínio personalizado, com o tipo, o nome, o valor e o status de cada um. Sem um domínio personalizado, avisa para configurar um antes.

## `squarecloud app domains`

```bash Uso theme={"system"}
squarecloud app domains [--json]
```

Lista todos os domínios configurados em todas as suas aplicações: hostname, tipo e o ID da aplicação dona dele.

## `squarecloud app load-balancers`

```bash Uso theme={"system"}
squarecloud app load-balancers [--json]
```

**Aliases:** `lb`

Lista os domínios personalizados vinculados a mais de uma aplicação (load balancers), agrupados por hostname, com o ID, o nome e o cluster de cada aplicação que compartilha o domínio. A saída começa com quantas aplicações por domínio o seu plano permite.

```bash theme={"system"}
squarecloud app lb --json
# Imprime a lista bruta de load balancers em JSON.
```

## Relacionados

| Comando | API | SDK JavaScript |
| - | - | - |
| `network domain` | [`POST .../network/custom`](/pt-br/api-reference/endpoint/apps/network/custom) | [`api.apps.network.setDomain()`](/pt-br/sdks/js/network) |
| `network dns` | [`GET .../network/dns`](/pt-br/api-reference/endpoint/apps/network/dns) | [`api.apps.network.dns()`](/pt-br/sdks/js/network) |
| `domains` | [`GET /v2/apps/domains`](/pt-br/api-reference/endpoint/apps/domains) | [`api.apps.domains()`](/pt-br/sdks/js/managing_application) |
| `load-balancers` | [`GET /v2/apps/load-balancers`](/pt-br/api-reference/endpoint/apps/network/load-balancers) | [`api.apps.loadBalancers()`](/pt-br/sdks/js/managing_application) |

O tráfego, os erros e o cache de um site estão em [Analytics da edge](/pt-br/cli-reference/edge-analytics).