Installation

Télécharger

Récupérez la dernière version sur la page de téléchargement :

Système	Fichier
macOS (Apple Silicon et Intel)	.dmg : glissez Joppa dans Applications
Linux x86_64	.AppImage (portable, à rendre exécutable : chmod +x Joppa_amd64.AppImage) ou .deb (Debian, Ubuntu : sudo apt install ./Joppa_amd64.deb)

Premier lancement sur macOS

Joppa n’est pas encore signé par Apple : macOS bloque donc sa première ouverture. C’est attendu, et il ne le demande qu’une fois.

1. Ouvrez Joppa depuis Applications. macOS affiche « « Joppa » n’a pas été ouvert » : cliquez sur Terminé, pas sur Placer dans la corbeille.
2. Ouvrez Réglages Système › Confidentialité et sécurité et descendez jusqu’à Sécurité.
3. En face de « « Joppa » a été bloqué pour protéger votre Mac », cliquez sur Ouvrir quand même.
4. Confirmez avec Ouvrir quand même, puis votre mot de passe ou Touch ID.

La page de téléchargement montre ces étapes en images.

Au premier lancement, Joppa crée son dossier de configuration, son autorité de certification et démarre le proxy HTTPS. Il vit ensuite dans la barre des menus : fermer la fenêtre ne l’arrête pas.

Approuver le certificat

Joppa signe un certificat pour chaque domaine avec une autorité de certification locale (CA). Pour que le navigateur affiche le cadenas, votre système doit faire confiance à cette autorité. C’est à faire une seule fois, avec un mot de passe administrateur.

Ouvrez Réglages › Autorité de certification : Joppa affiche la commande exacte pour votre machine, avec un bouton pour la copier.

macOS

sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain \
  "$HOME/Library/Application Support/joppa/ca/rootCA.pem"

Joppa vérifie la confiance tout seul : la barre d’état passe à CA ok dès que c’est fait.

Linux

sudo cp ~/.config/joppa/ca/rootCA.pem /usr/local/share/ca-certificates/joppa-rootCA.crt
sudo update-ca-certificates

Les ports 80 et 443

Le proxy écoute sur 127.0.0.1, port 443 (HTTPS) et 80 (redirection vers HTTPS). Il n’accepte que les connexions de votre machine.

• macOS : rien à faire.
• Linux : les ports sous 1024 demandent un droit particulier. Si Joppa ne peut pas les ouvrir, il affiche la commande à lancer :

sudo setcap cap_net_bind_service=+ep /chemin/vers/joppa

Si seul le port 80 est indisponible, le proxy tourne quand même ; la redirection HTTP → HTTPS est simplement désactivée.

La résolution des domaines .test

Le navigateur doit savoir que monprojet.test désigne votre machine (127.0.0.1). Joppa ne modifie pas votre configuration DNS : si un domaine ne répond pas alors que le proxy tourne, faites résoudre *.test vers 127.0.0.1.

Sur macOS, avec dnsmasq (Homebrew) :

brew install dnsmasq
echo 'address=/.test/127.0.0.1' >> "$(brew --prefix)/etc/dnsmasq.conf"
sudo brew services start dnsmasq
sudo mkdir -p /etc/resolver
echo 'nameserver 127.0.0.1' | sudo tee /etc/resolver/test

Un runtime de conteneurs (facultatif)

Les domaines et le HTTPS n’ont besoin de rien d’autre. Pour les services (PostgreSQL, Redis, Mailpit…), installez l’un de ces runtimes : OrbStack, Docker Desktop, Colima ou Podman. Voir Runtimes de conteneurs.

Vérifier

La barre d’état en bas de la fenêtre résume tout :

joppa   proxy :443   CA joppa ok   2/2 domaines en ligne   1/1 service

Vous pouvez passer aux premiers pas.