Vue d'ensemble des services
Les bases de données, caches, serveurs mail et moteurs de recherche que Joppa fait tourner dans des conteneurs, et comment les ajouter.
Un service est un serveur partagé par vos projets, que Joppa fait tourner dans votre runtime de conteneurs. Ouvrez Services dans la barre latérale : la page liste vos services, puis le catalogue.
Le catalogue
| Service | Versions | Port par défaut | Compte ou clé |
|---|---|---|---|
| PostgreSQL | 18, 17, 16, 15, 14 | 5432 | postgres / postgres |
| MySQL | 9.7, 8.4, 8.0 | 3306 | root / root |
| MariaDB | 12.3, 11.8, 11.4, 10.11 | 3306 | root / root |
| Redis | 8.10, 8.8, 7.4 | 6379 | — |
| Valkey | 9.2, 9.1, 8.1 | 6379 | — |
| Mailpit | 1.31 | SMTP 1025, boîte web 8025 | — |
| Typesense | 30.2, 29.1 | 8108 | clé API joppa-local-key-0000 |
| Meilisearch | 1.55, 1.54 | 7700 | clé maître joppa-local-key-0000 |
La première version listée est celle proposée par défaut.
Ajouter un service
Cliquez sur + Ajouter PostgreSQL (ou un autre) dans le catalogue. Choisissez la version et le port : Joppa propose le premier port libre à partir du port par défaut (un deuxième serveur MySQL prendra 3307). Le service démarre dans un conteneur nommé joppa-<moteur>.
Tous les services écoutent sur 127.0.0.1 seulement : ils ne sont pas visibles depuis le réseau.
La page d’un service
- Démarrer / Arrêter, et depuis combien de temps il tourne.
- Copier l’URL du serveur (ou l’adresse, la clé API, la clé maître selon le service).
- Ouvrir dans TablePlus pour les bases et les caches, Ouvrir la boîte pour Mailpit, Ouvrir l’aperçu pour Meilisearch.
- Projets : les projets qui l’utilisent, Connecter un projet et Délier. Joppa écrit l’adresse du service dans leur
.envet la garde à jour. - journal : les logs du conteneur, avec Suivre.
- Menu Actions : Version et port… (ou Version, port et extensions… pour PostgreSQL) et Retirer le service….
Changer de version ou de port
Les changements s’appliquent au prochain démarrage ; la page propose ↻ Appliquer les changements (le conteneur est recréé, les données restent).
- Chaque version a ses propres données, dans un volume (
joppa-postgres-17). Passer de la 17 à la 18 démarre un serveur vide ; revenir à la 17 retrouve ses bases. - Changer de port met à jour le
.envdes projets liés.
Retirer un service
Retirer le service… supprime le conteneur. Les données restent dans leur volume : réajouter le même service les retrouve.
Port occupé
Si le port est déjà pris, la page affiche « ✕ Le port 5432 est occupé par … » avec deux options : Changer de port, ou Libérer le port. Joppa identifie le coupable et propose l’action adaptée :
| Occupant | Action proposée |
|---|---|
| Conteneur Docker, Compose ou Lerd | L’arrêter |
| Service Homebrew | brew services stop … (il ne redémarrera plus à l’ouverture de session) |
| Postgres.app | Impossible depuis Joppa : cliquez sur « Stop » dans Postgres.app |
| Autre processus | L’arrêter directement, après confirmation |