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, dans le Docker, Podman, OrbStack ou Colima que vous avez déjà.
localhost:5173 → https://app.acme.test 🔒
localhost:8000 → https://api.acme.test 🔒
postgres (conteneur) → 127.0.0.1:5432 · base acme · pgvector
Par où commencer
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 (Joppa Pro).
- Inspecteur de requêtes : les en-têtes et le corps de chaque appel, rejoués tels quels ou modifiés, copiés en cURL (Joppa Pro).
- Nouveau projet depuis un modèle : Vite+, Next.js, Nuxt, Astro, SvelteKit, Laravel ou un dépôt GitHub.
- Migration depuis Lerd, Herd, DDEV ou Sail : vos sites, leurs domaines, leurs bases et leur
.envrepris en une fois.
Pour vos services
- Bases de données : PostgreSQL (avec pgvector, PostGIS…), MySQL et MariaDB, une base par projet.
- Cache, mail et recherche : Mailpit, et avec Joppa Pro Redis, Valkey, 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, .deb et paquet joppa-bin pour Arch) |
| Windows | En cours de développement |
Joppa est gratuit, avec des projets illimités, PostgreSQL, MySQL, MariaDB et Mailpit. Joppa Pro ajoute Analytics, l’inspecteur de requêtes, Redis, Valkey, Typesense et Meilisearch, et plusieurs serveurs d’un même moteur ; l’offre Équipe le donne à chaque membre.