Concepts
Projet, domaine, proxy, autorité de certification, processus et service : les pièces de Joppa et comment elles s'assemblent.
Vue d’ensemble
Navigateur ── https://app.monprojet.test ──▶ Proxy Joppa (:443, TLS)
│ certificat signé par la CA locale
├──▶ localhost:5173 serveur de dev (Vite)
└──▶ localhost:8000 API (Laravel)
│
▼
PostgreSQL / Redis / Mailpit…
(conteneurs Docker ou Podman)Projet
Un projet est un dossier de votre disque que Joppa connaît : un nom, une icône, des domaines, et éventuellement des processus, des variables d’environnement et des versions épinglées. Le nom sert de base aux domaines : le projet kinosante reçoit kinosante.test et ses sous-domaines.
Retirer un projet de Joppa ne supprime jamais son dossier.
Domaine
Un domaine relie une adresse https://…test à un port local : https://api.kinosante.test → localhost:8000. Un projet en a autant que de serveurs de dev. Chaque domaine peut être désactivé sans être supprimé.
Le TLD .test est réservé par l’IETF aux tests : il ne sera jamais attribué sur Internet, il ne peut donc pas entrer en conflit avec un vrai site.
Proxy
Le proxy est un reverse proxy HTTPS intégré à Joppa. Il écoute sur les ports 443 et 80 de 127.0.0.1, choisit le bon certificat d’après le nom demandé, puis transmet la requête au port du domaine. Il gère HTTP/2, les WebSockets (HMR) et les Server-Sent Events. Voir Proxy HTTPS.
Autorité de certification
L’autorité de certification (CA) locale signe à la volée un certificat pour chaque domaine. Une fois approuvée par votre système, tous les domaines présents et futurs sont de confiance. Voir Certificats.
Processus
Un processus est une commande que Joppa lance pour un projet : un script dev de package.json ou un service Docker Compose du projet. Joppa connaît leur ordre, leur port, et relance ceux qui plantent. Voir Processus.
Service
Un service est un serveur partagé que Joppa fait tourner dans un conteneur : PostgreSQL, MySQL, MariaDB, Redis, Valkey, Mailpit, Typesense ou Meilisearch. Un serveur sert tous vos projets ; pour les bases de données, chaque projet a sa propre base. Lier un service à un projet écrit ses variables dans le .env. Voir Services.
Runtime de conteneurs
Le runtime est l’outil qui fait tourner les conteneurs des services : OrbStack, Docker Desktop, Colima ou Podman. Il n’est nécessaire que pour les services. Voir Runtimes de conteneurs.
L’app, le terminal et les assistants
L’app de bureau est le cœur de Joppa : elle fait tourner le proxy et garde l’état. La commande joppa, son TUI et le serveur MCP parlent à l’app qui tourne, par une API locale ; ils font la même chose que la fenêtre.