Dépannage
Les problèmes les plus courants, domaine qui ne répond pas, certificat refusé, port occupé, Docker absent, et comment les régler.
Commencez toujours par la barre d’état en bas de la fenêtre (ou joppa status) : elle dit si le proxy tourne, si la CA est approuvée et combien de domaines répondent.
Le domaine ne répond pas
Le navigateur ne trouve pas le site (DNS_PROBE_FINISHED_NXDOMAIN). Le nom .test ne résout pas vers votre machine. Voir Installation › La résolution des domaines .test.
« Le serveur de dev ne répond pas » (502). Le proxy fonctionne, mais rien n’écoute sur le port cible. Lancez le serveur de dev, vérifiez son port dans l’onglet Domaines, ou laissez Joppa le lancer depuis Processus.
« Domaine non configuré ». Ce nom n’est attaché à aucun projet, ou le domaine est désactivé. Ajoutez-le dans l’onglet Domaines.
Rien ne répond du tout. Le proxy est arrêté (bandeau en haut de la fenêtre) : Démarrer le proxy.
« Blocked request. This host is not allowed. »
Vite ou Astro refusent le domaine. L’onglet Domaines propose Corriger le fichier. Voir Réglages du framework.
Le navigateur affiche « Non sécurisé »
La CA n’est pas approuvée par le système : la barre d’état affiche CA … non approuvée. Lancez la commande de Réglages › Autorité de certification, puis redémarrez le navigateur. Sous Linux, importez aussi la CA dans Firefox. Voir Certificats.
Les URL générées sont en http://
Votre framework ne sait pas qu’il est derrière un proxy HTTPS. Laravel : voir Laravel derrière un proxy. Les autres frameworks lisent X-Forwarded-Proto.
Le proxy ne démarre pas
- Lerd tient les ports : le bandeau propose Couper Lerd et démarrer. Voir Cohabiter avec Lerd.
- Un autre programme tient le port 443 (Valet, nginx, Caddy, un autre proxy) : arrêtez-le.
- Linux, permission refusée :
sudo setcap cap_net_bind_service=+ep <chemin de joppa>. - « Redirection HTTP → HTTPS désactivée » : seul le port 80 est pris ; HTTPS fonctionne.
Un service ne démarre pas
- « Aucun runtime de conteneurs » : installez ou lancez OrbStack, Docker Desktop, Colima ou Podman. Voir Runtimes de conteneurs.
- « Le port 5432 est occupé par … » : un autre PostgreSQL tourne (Homebrew, Postgres.app, Docker). Libérer le port ou Changer de port. Voir Port occupé.
- La première fois avec des extensions : la construction de l’image PostgreSQL prend quelques minutes.
Un processus plante en boucle
Ouvrez le terminal (⌘ J) et l’onglet du processus : la dernière erreur y est. Après le nombre de relances choisi, Joppa abandonne et l’indique. Voir Relancer après un plantage.
Le projet ne voit pas ses nouvelles variables
Les serveurs de dev ne relisent le .env qu’au démarrage : redémarrez-les (depuis l’onglet Processus si Joppa les lance).
La commande joppa dit que Joppa n’est pas lancé
Code de sortie 3. Lancez l’app, ou ajoutez --launch. Si l’app tourne, réinstallez la commande depuis Réglages › Ligne de commande.
Toujours bloqué ?
Écrivez-nous depuis l’app : Support, en bas de la barre latérale (ou « Écrire au support » dans la palette ⌘ K). La version de Joppa et votre système sont joints au message. Sans licence activée, l’app vous envoie sur getjoppa.com : vous recevez un lien de connexion par e-mail, avec ou sans licence, puis le formulaire s’ouvre. Le même formulaire est accessible depuis le pied de page du site.
Vous pouvez aussi écrire à [email protected], avec la sortie de joppa status. Pour une simple question : [email protected].