Docs Hébergement Domaines et URLs Référence des domaines et URLs Référence des domaines et URLs Écrans, champs, formats, statuts et limites des domaines, URLs, routes, domaines racines, préfixes et hôtes IAM.
Référence Développeur
Mis à jour le 23 octobre 2026
Les domaines et les URLs se gèrent depuis la console Wakastart (https://app.wakastart.app). Il n'existe pas d'API publique pour ces opérations.
Écrans#
Écran Chemin dans la console Accès Domaines App > Architecture > URLs > Domaines Droit « Infra Client » URLs publiques App > Architecture > URLs Droit « Infra Client » URLs & IAM App > Environnements > environnement > onglet URLs & IAM Droit « Voir les URLs/routage » pour l'afficher, « Gérer les URLs/routage » pour agir, « Modifier un environnement » pour le préfixe et la gateway ; « Accès infrastructure en production » en plus sur un environnement prod Section Hôtes IAM Onglet URLs & IAM Niveau Administrateur réseau et droit « Gérer les URLs/routage » Mapping IAM App > Environnements > onglet Mapping IAM Droit « Infra Client »
Domaine#
Champ à l'écran Format Notes Nom de domaine 1 à 255 caractères Unique sur toute la plateforme. Non modifiable Provider DNS OVH , IONOS Cloud , IONOS Hosting Non modifiable depuis la console Zone DNS Nom de la zone chez le fournisseur La zone doit déjà exister chez le fournisseur Credentials DNS Champs propres au fournisseur Stockés dans le coffre, jamais réaffichés
Fournisseur Champs d'identifiants OVH OVH Endpoint (ovh-eu, ovh-ca, ovh-us), Application Key , Application Secret , Consumer Key IONOS Cloud API Token IONOS Hosting API Key
État affiché (colonne Credentials DNS ) Signification Aucun credential DNS configuré Aucun identifiant enregistré Configuration en cours... Identifiants enregistrés, mise à disposition en cours Credentials actifs Identifiants disponibles pour les écritures DNS Échec de la configuration La mise à disposition a échoué ; le motif s'affiche dessous
URL#
Champ Format Notes Sous-domaine ^[a-z][a-z0-9-]{0,61}[a-z0-9]$ ou une seule lettre, 63 caractères au plusUnique par domaine dans l'app Domaine Domaine plateforme ou domaine personnalisé de l'app —
Statuts d'une URL dans l'architecture : Actif , Détachée (sans domaine), Suppression... , Supprimé .
Route#
Champ Valeurs Défaut URL de rattachement Une URL active de l'app — Chemin Commence par /, sans / final sauf pour / /Type de chemin PathPrefix, Exact, RegularExpressionPathPrefixService Une définition de service de l'app — Port (optionnel) À laisser vide Port de la définition du service URL front officielle de l'app Case à cocher, une seule route par app, service de rôle FRONT Non cochée
Un même chemin ne peut exister qu'une fois par URL.
Domaine racine#
Champ Valeurs Défaut Domaine Domaine personnalisé sans domaine racine ni redirection depuis sa racine — Service Une définition de service de l'app — Chemin / Type de chemin Comme une route /, PathPrefix
Un seul domaine racine par domaine. Enregistrement DNS toujours de type A ou AAAA.
Préfixe d'environnement#
Règle Valeur Format ^[a-z][a-z0-9-]{0,19}$ : commence par une lettre minuscule, puis minuscules, chiffres et tirets, 20 caractères au plusVide Noms publiés sans préfixe ; un seul environnement par app Unicité Un préfixe par environnement au sein d'une app
Cas Nom d'hôte URL sur un domaine personnalisé <sous-domaine>[.<préfixe>].<domaine>URL sur un domaine plateforme <sous-domaine>[.<préfixe>].<identifiant court de l'app>.<domaine>Domaine racine [<préfixe>.]<domaine>
Statuts d'une route, d'un domaine racine ou d'une redirection dans un environnement#
Statut Signification PENDINGInstanciation enregistrée, pas encore prise en charge PROVISIONINGCréation du rattachement, du certificat et du DNS en cours PROVISIONEDCertificat valide et DNS écrit, trafic servi FAILEDÉchec durable DESTROYINGRetrait en cours DESTROYEDRetiré
Hôte IAM#
Champ Format Notes Pattern d'hôte Nom d'hôte complet, 255 caractères au plus Unique sur toute la plateforme pour une app *Wildcard ( . ) Case à cocher Couvre les sous-domaines du motif App mobile (deep link) Case à cocher Remplace le motif par Schéma (^[a-z][a-z0-9+.-]*$, 100 caractères au plus) et Chemin callback (défaut callback) Actif Case à cocher Un hôte inactif n'est plus résolu Hôte local <identifiant de l'app>.localhost:<port>En dev uniquement
Élément Valeur Certificat Let's Encrypt, défi HTTP-01, un par nom d'hôte, sans wildcard Relance d'un certificat en échec après 10 min, puis après 30 min ; FAILED au troisième échec Redirection HTTP vers HTTPS 301TTL des enregistrements DNS 300 s (3 600 s chez IONOS Hosting) Délais du load balancer 180 s d'inactivité côté client et côté service, 20 s pour établir la connexion Prise en charge d'une instanciation demandes explicites toutes les 10 s, nouvelles ressources toutes les 30 s, rattrapage toutes les 5 min