# Adresse et domaines

> Chaque application répond en HTTPS sur une adresse arkya.app. Ajoute ton propre domaine avec un enregistrement DNS ; le certificat suit tout seul.

Source : https://docs.arkya.gg/applications/domaines

## L’adresse arkya.app

Dès sa première mise en service, ton application répond sur une adresse de la forme `mon-api-a1b2c3d.arkya.app`, en HTTPS. `ark deploy`, `ark info` et l’onglet **Domaines** l’affichent.

Une application est toujours publique sur le web. Pour qu’un service reste privé, comme une base, garde-le dans le projet : voir [Les projets](https://docs.arkya.gg/demarrer/projets).

## Ajouter ton domaine

1. Ouvre l’onglet **Domaines** de l’application.
2. Ajoute ton domaine, par exemple `app.mondomaine.fr`.
3. Chez ton registrar, pose l’enregistrement que l’onglet affiche : un `CNAME` vers l’adresse `arkya.app` de l’application.

```text
app.mondomaine.fr.   CNAME   mon-api-a1b2c3d.arkya.app.
```

Le certificat TLS est émis automatiquement dès que le DNS pointe sur Arkya. Compte quelques minutes, le temps que le DNS se propage.

## Un domaine nu

Un domaine sans sous-domaine, comme `mondomaine.fr`, n’accepte pas de `CNAME`. Pose à la place un enregistrement `A` vers l’adresse IP de l’application, ou un `ALIAS` si ton fournisseur DNS le propose.

```bash
dig +short mon-api-a1b2c3d.arkya.app
```

## Les règles

- Un domaine ne sert qu’une application à la fois.
- Les noms en `arkya.app` sont réservés aux adresses d’Arkya.
- Chez Cloudflare, laisse le domaine en « DNS seul », nuage gris : Arkya émet et sert lui-même le certificat.

## Quand le certificat n’arrive pas

Vérifie d’abord que ton domaine pointe bien sur Arkya :

```bash
dig +short app.mondomaine.fr
```

Si le DNS est bon mais que le navigateur signale toujours un certificat invalide, retire le domaine dans l’onglet **Domaines**, puis ajoute-le de nouveau : l’émission repart.

## Depuis l’API

`GET`, `POST` et `DELETE` sur `/api/apps/mon-api/domains` lisent, ajoutent et retirent les domaines. Le CLI n’a pas encore de commande pour cela. Voir [L’API HTTP](https://docs.arkya.gg/api).