Vue d'ensemble des services

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 .env et 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 .env des 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