Introduction
Joppa donne à chaque projet local un domaine .test, un certificat de confiance et ses bases de données. Cette documentation explique tout ce qu'il fait, et comment.
Joppa est une app de bureau pour macOS et Linux qui remplace la configuration de votre environnement de dev local. Vous lui donnez un dossier ; il trouve les serveurs de dev qui s’y lancent, leur donne une adresse https:// qui ressemble à la production, et fait tourner les bases de données dont le projet a besoin.
localhost:5173 → https://app.kinosante.test 🔒
localhost:8000 → https://api.kinosante.test 🔒
postgres (conteneur) → 127.0.0.1:5432 · base kinosante · pgvector
Par où commencer
InstallationTélécharger Joppa, approuver le certificat et faire résoudre les domaines .test.
Premiers pasVotre premier projet en HTTPS, en cinq minutes.
ConceptsProjet, domaine, proxy, service : le vocabulaire de Joppa.
Raccourcis clavierToute l'app se pilote au clavier, ⌘K en tête.
Ce que fait Joppa
Pour vos projets

- Domaines
.testen HTTPS : un domaine par serveur de dev (app.monprojet.test,api.monprojet.test), avec un certificat de confiance. - Processus : Joppa lance vos serveurs de dev et vos conteneurs Compose dans le bon ordre, avec un terminal intégré et une relance après un plantage.
- Variables d’environnement : le
.envest tenu à jour avec les domaines et les services, toujours avec un diff avant d’écrire. - Versions de Node, bun et PHP épinglées par projet.
- Analytics : requêtes, latence, erreurs et disponibilité de vos serveurs de dev.
- Nouveau projet depuis un modèle : Vite+, Next.js, Nuxt, Astro, SvelteKit, Laravel ou un dépôt GitHub.
Pour vos services
- Bases de données : PostgreSQL (avec pgvector, PostGIS…), MySQL et MariaDB, une base par projet.
- Cache, mail et recherche : Redis, Valkey, Mailpit, Typesense et Meilisearch.
- Import depuis Docker Compose : vos données copiées dans Joppa, sans toucher à la source.
Partout
- La commande
joppa, une app plein écran dans le terminal et un serveur MCP pour Claude et Cursor. - La palette ⌘K et un raccourci pour chaque action.
Systèmes pris en charge
| Système | État |
|---|---|
| macOS | Disponible (Apple Silicon et Intel) |
| Linux | Disponible (.AppImage et .deb) |
| Windows | En cours de développement |
Joppa est gratuit jusqu’à 3 projets et 1 service. Joppa Pro lève ces limites.