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

# Domaine personnalisé

> Pointer votre nom de domaine vers une application, avec un certificat HTTPS automatique

Chaque application est joignable en HTTPS dès son déploiement, sur une adresse générée à partir de l'IP publique de votre instance. Cette adresse sert aux essais ; pour la production, attachez votre propre nom de domaine.

## HTTPS automatique

L'adresse générée porte déjà un certificat Let's Encrypt, émis et renouvelé par la plateforme. Il en va de même pour un domaine personnalisé : dès que le domaine résout vers votre instance, le certificat est demandé automatiquement.

## Ajouter un domaine

<Info>
  **Prérequis**

  * Un nom de domaine que vous contrôlez
  * L'application déployée et en cours d'exécution
</Info>

<Steps>
  <Step title="Ouvrir l'onglet Domaines">
    Ouvrez l'application, puis sélectionnez l'onglet **Domaines**.
  </Step>

  <Step title="Saisir le domaine">
    Saisissez le nom d'hôte à attacher, par exemple `app.exemple.fr`. La console le vérifie pendant la saisie et vous indique ce qui va se passer.
  </Step>

  <Step title="Choisir le service">
    Une application composée de plusieurs services demande lequel reçoit le domaine.
  </Step>

  <Step title="Appliquer">
    Sélectionnez **Ajouter**. La tâche applique le domaine et le certificat est émis peu après.
  </Step>
</Steps>

## Deux cas de figure

### La zone DNS est gérée chez OnetSolutions

Si le domaine parent possède une zone DNS dans la même organisation, la console vous le signale et crée l'enregistrement A pour vous. Vous n'avez rien à faire.

L'enregistrement pointe vers l'adresse IPv4 publique de l'instance, avec un TTL de 300 secondes. Un enregistrement A existant avec une autre valeur est mis à jour, et son ancienne valeur est conservée dans l'historique de l'application.

<Warning>
  Un enregistrement `CNAME` portant le même nom, ou plusieurs enregistrements `A`, bloquent l'opération. Supprimez-les d'abord de votre zone DNS.
</Warning>

### La zone DNS est ailleurs

Si le domaine est hébergé chez un autre prestataire, la console affiche l'adresse IP à pointer. Créez un enregistrement `A` chez votre registrar, puis ajoutez le domaine : la console vérifie que le nom résout bien vers votre instance avant de l'appliquer.

La propagation DNS prend de quelques minutes à quelques heures. Si la vérification échoue juste après la création de l'enregistrement, patientez et réessayez.

## Retirer un domaine

Retirer un domaine de la liste puis appliquer le changement le détache de l'application. L'enregistrement DNS, lui, n'est pas supprimé : retirez-le de votre zone si vous n'en avez plus besoin.