Domaines

L’onglet Domaines (D) liste les domaines du projet. Chacun est servi en HTTPS et redirigé vers son serveur local.

Le tableau des domaines

Colonne	Contenu
État	Pastille de santé du domaine
Domaine	https://app.monprojet.test ↗, cliquable
Cible	→ localhost:5173
Lancé par	Le processus qui sert ce port, s’il y en a un
Actif	Un interrupteur : un domaine désactivé ne répond plus, sans être supprimé

Les actions de chaque ligne : démarrer ou arrêter le processus, copier l’URL, supprimer le domaine.

Les états

État	Signification
en ligne	Le serveur de dev répond sur son port
hors ligne	Rien n’écoute sur le port
désactivé	Le domaine est coupé (interrupteur Actif)
sans proxy	Le proxy est arrêté : aucun domaine ne répond
démarrage…	Le processus qui sert ce port est en train de démarrer
processus en échec	Le processus a planté
arrêté	Le processus est arrêté

Ajouter un domaine

Sous le tableau, remplissez les deux champs puis + Ajouter (raccourci A pour aller au champ) :

• Sous-domaine ou domaine complet : admin devient admin.monprojet.test ; un nom avec un point (docs.autre.test) est pris tel quel.
• Port : 3000 devient la cible http://localhost:3000.

Les noms acceptent les lettres a–z, les chiffres et les tirets, 63 caractères par segment et 253 au total. Deux projets ne peuvent pas avoir le même domaine.

Réglages du framework

Sous les domaines, le bloc À régler dans le projet signale ce qui empêcherait le projet de répondre sur son domaine, avec le code à ajouter.

Vite et Astro : allowedHosts

Vite (et Astro, qui l’utilise) refusent les requêtes adressées à un domaine inconnu. Joppa propose d’ajouter :

// vite.config.ts
export default defineConfig({
  server: { allowedHosts: [".monprojet.test"] },
});

// astro.config.mjs
export default defineConfig({
  vite: { server: { allowedHosts: [".monprojet.test"] } },
});

Corriger le fichier ouvre un aperçu, puis Écrire le fichier insère seulement ces lignes ; le reste du fichier ne bouge pas. Si la config a une forme inhabituelle, Joppa ne la modifie pas : Copier le code et collez-le vous-même. Autre option, sans toucher au fichier : la variable __VITE_ADDITIONAL_SERVER_ALLOWED_HOSTS=.monprojet.test.

Relancez le serveur de dev pour qu’il relise sa config.

Laravel derrière un proxy

Laravel doit faire confiance au proxy pour générer des URL en https://. Dans bootstrap/app.php :

->withMiddleware(fn ($m) => $m->trustProxies(at: '*'))

Ce réglage n’est pas écrit automatiquement : copiez-le.

Les en-têtes transmis

Le proxy conserve l’en-tête Host d’origine (app.monprojet.test) et ajoute les en-têtes X-Forwarded-* : X-Forwarded-Proto: https, X-Forwarded-Host, X-Forwarded-Port: 443 et X-Forwarded-For. Voir Proxy HTTPS.