# Dominios

Cada aplicación recibe una dirección gratuita que sigue funcionando. Para su propio nombre, como `app.suempresa.com`, compre un dominio con <Term id="credits">créditos</Term>, conecte uno propio o agregue un nombre bajo un dominio que su <Term id="workspace">espacio de trabajo</Term> ya usa. HTTPS se activa solo.

## Antes de empezar [#antes-de-empezar]

<Callout type="warn" title="Las compras de dominios no se reembolsan">
  Comprar y renovar descuentan [créditos](/docs/es/workspace/credits) de inmediato. Revise el nombre y la terminación antes de comprar.
</Callout>

- El <Term id="project">proyecto</Term> debe estar desplegado, o a punto de estarlo: un dominio abre la versión publicada.
- Necesita poder cambiar el proyecto.
- Comprar cuesta créditos. Conectar un dominio propio, o reutilizar uno conectado, es gratis.

## Dónde están los dominios [#dónde-están-los-dominios]

- **Los dominios de un proyecto**: abra el proyecto en <AppLink to="deploy" />, busque **Dominios** y seleccione **Administrar** para ver todas las direcciones en las que responde.
- **Todas las direcciones de su espacio de trabajo**: <AppLink to="settings.domains" /> lista todas las direcciones de todos los proyectos. Busque por dirección o proyecto y filtre por **Dirección gratuita**, **Conectado**, **Comprado** o **Sin proyecto**.

<Screenshot src="/docs/_media/settings-domains-list-of-all-domains.png" alt="La página Dominios con todos los dominios del espacio de trabajo" />

## Agregar un dominio [#agregar-un-dominio]

Seleccione **Agregar dominio** y elija **Comprar un dominio nuevo**, **Conectar un dominio externo** o **Usar un dominio conectado**.

<Screenshot src="/docs/_media/deploy-projects-domains-add-domain.png" alt="La página Agregar un dominio con sus tres formas de agregar un dominio" />

### Comprar un dominio nuevo [#comprar-un-dominio-nuevo]

Pague con créditos y Klarety configura sus registros por usted.

<Steps>
<Step>
### Busque un nombre [#busque-un-nombre]
En **Busque un nombre**, escriba el nombre que quiere (por ejemplo `suempresa`) y luego **Elija una terminación**. Cada una muestra su precio anual en créditos, o **No disponible**. Seleccione **Continuar**.
</Step>
<Step>
<Screenshot src="/docs/_media/deploy-projects-domains-buy-domain-search-page.png" alt="Búsqueda de un nombre de dominio, con precios por terminación" />

### Indique quién es el dueño [#indique-quién-es-el-dueño]
En **Quién es el dueño**, complete el nombre, el correo, el teléfono y la dirección del dueño; el registro lo anota como dueño. El correo no se puede cambiar después de comprar y recibe un enlace de confirmación.
</Step>
<Step>
<Screenshot src="/docs/_media/deploy-projects-domains-buy-domain-owner.png" alt="El paso Propietario al comprar un dominio" />

### Revise y compre [#revise-y-compre]
**Revisar pedido** muestra el dominio, el dueño, el precio por un año, que tiene **Renovación anual** y su **Saldo después**. Acepte los Términos del servicio y seleccione **Comprar por X créditos**.
</Step>
<Step>
### Confirme el correo del dueño [#confirme-el-correo-del-dueño]

<Callout type="error" title="Confirme dentro de 15 días">
  Sin la confirmación, el dominio deja de funcionar 15 días después de la compra.
</Callout>

Haga clic en el enlace de confirmación que se envió al correo del dueño.
</Step>
</Steps>

<Screenshot src="/docs/_media/deploy-projects-domains-buy-domain-owner.png" alt="El paso Revisar pedido al comprar un dominio, con el precio y el Saldo después" />

El dominio queda en línea solo en unos minutos, con HTTPS incluido.

### Conectar un dominio externo [#conectar-un-dominio-externo]

Gratis, para un dominio que tiene en otro lugar. Usted agrega dos registros DNS donde lo administra.

<ForEveryone>

<Steps>
<Step>
### Escriba el dominio [#escriba-el-dominio]
Elija **Conectar un dominio externo**, escriba la dirección (por ejemplo `app.suempresa.com`) y seleccione **Conectar**.
</Step>
<Step>
### Agregue los registros [#agregue-los-registros]
La página muestra dos registros, cada uno con **Tipo**, **Nombre** y **Valor**. Agregue ambos donde administra el DNS de este dominio. Algunos proveedores solo quieren en **Nombre** la parte anterior a su dominio.
</Step>
<Step>
### Espere a que quede en línea [#espere-a-que-quede-en-línea]
Klarety revisa cada pocos segundos; puede salir de la página. El dominio pasa de **Agregue los registros de abajo** a **Activando HTTPS** y a **En línea**, por lo general en minutos. Mantenga los registros mientras se emite el certificado.
</Step>
</Steps>

<Screenshot src="/docs/_media/deploy-projects-domains-add-domain.png" alt="Los dos registros DNS que se muestran al conectar un dominio externo" />

</ForEveryone>

<ForDevelopers>

```python
from klarety import Nexus

nx = Nexus.connect()
added = nx.projects.add_domain("PROJECT_ID", "app.yourcompany.com")
print(added)

for domain in nx.projects.domains("PROJECT_ID"):
    print(domain)
```

`add_domain` devuelve los dos registros que debe agregar en su DNS. El dominio queda en línea cuando se encuentran.

</ForDevelopers>

<Callout type="warn" title="Dominios raíz">
  Para un dominio raíz como `suempresa.com`, su proveedor de DNS debe permitir un registro CNAME en la raíz. Si no lo permite, use `www.suempresa.com`.
</Callout>

### Usar un dominio conectado [#usar-un-dominio-conectado]

Gratis. Agregue un nombre nuevo bajo un dominio que ya está en Klarety, por ejemplo `api.suempresa.com` bajo `suempresa.com`.

Elija **Usar un dominio conectado**, elija uno de **Tus dominios**, escriba un **Nombre** (por ejemplo `api`) y seleccione **Agregar**. Déjelo vacío para usar el dominio mismo, si ninguna otra aplicación lo usa. La aplicación responde allí de inmediato.

## Elegir qué abre un dominio [#elegir-qué-abre-un-dominio]

Cuando una aplicación tiene varias partes, cada dominio abre una. **Lo responde** muestra cuál (por defecto, la principal). Para cambiarlo, seleccione **Cambiar lo que abre**, elija la parte y seleccione **Guardar**.

<ForDevelopers>

```python
nx.projects.point_domain("PROJECT_ID", "api.yourcompany.com", service="api")
```

`service=None` lo devuelve a la parte principal de la aplicación.

</ForDevelopers>

## Renovación de un dominio comprado [#renovación-de-un-dominio-comprado]

Un dominio comprado muestra cuándo **Se renueva con créditos**, o cuándo **Vence** si la renovación está desactivada.

- **Renovación activada**: en sus últimos 30 días, el dominio se renueva por un año con sus créditos. Si no alcanzan, Klarety lo intenta cada día hasta que venza.
- **Desactivar la renovación**: no se renovará. Cuando venza, su aplicación deja de responder allí y otra persona podría comprarlo.
- **Renovar un año ahora**: renueva por un año más de inmediato, pagado con créditos ahora y sin reembolso.

## Llevar un dominio a otro registrador [#llevar-un-dominio-a-otro-registrador]

Seleccione **Llevar a otro registrador** y confirme. Klarety lo desbloquea y muestra un **Código de transferencia** para su nuevo registrador. Deja de renovarse aquí. Un dominio comprado en los últimos 60 días aún no se puede mover.

## Quitar o liberar un dominio [#quitar-o-liberar-un-dominio]

- **Quitar** saca un dominio de un proyecto; la aplicación deja de responder allí de inmediato. Puede agregarlo de nuevo más tarde.
- Cuando se elimina un proyecto, sus dominios muestran **Ningún proyecto lo usa**. Seleccione **Usar en este proyecto** para dárselo a otro proyecto, o **Liberar** para soltarlo: se quita su certificado y quien sea su dueño puede agregarlo de nuevo. Un dominio comprado aquí sigue comprado y conserva su renovación.

## Si algo sale mal [#si-algo-sale-mal]

- **El dominio sigue en Agregue los registros de abajo**: revise que ambos registros coincidan exactamente, incluido **Nombre** como lo espera su proveedor. Algunos proveedores tardan en publicar cambios.
- **"Eso no parece un dominio"**: use letras, números, guiones y puntos, como `app.suempresa.com`.
- **"No tiene créditos suficientes para este dominio"**: seleccione **Agregar créditos** y luego compre.
- **Un dominio comprado dejó de funcionar**: revise que el dueño hizo clic en el enlace de confirmación dentro de los 15 días.
- **"Solo quienes pueden cambiar este proyecto pueden agregar un dominio"**: pídaselo al propietario del proyecto o a un administrador.

## Siguientes pasos [#siguientes-pasos]

- [Desplegar una aplicación](/docs/es/deploy/deploy-an-app)
- [Créditos](/docs/es/workspace/credits)
- [Registros](/docs/es/deploy/logs)