Service Launchers

Projet / Project: Une commande unique pour chaque service local / a single command for every local service Date: 2026-09-19 · Statut / Status: ✅ 9 scripts créés, syntaxe vérifiée, dashboard en marche / 9 scripts created, syntax-checked, dashboard live Machine / Machine: Zelus (Fedora 44) · ~/.local/bin (sur le PATH / on PATH) Contexte / Context: après l’arrêt complet des services (voir Killing Local Services - Bilingual Report (FR-EN)), on généralise le confort de fcc / odin à tout le parc / after the full service shutdown, we generalize the fcc / odin convenience to the whole fleet Auteur / Author: Moi, avec mon copilote IA comme partenaire de travail / Me, with my AI copilot as working partner


1. Pourquoi

J’avais déjà deux fonctions dans ~/.bashrc (fcc, odin) qui lancent freeCodeCamp et The Odin Project en une commande, et deux scripts dans ~/.local/bin (misskey, idlezelus) avec un vrai cycle de vie (start/stop/status). Mais strapi, linux journey, dartpad, peertube, jitsi, rocketchat, matrix et supabase se lançaient encore à la main (mémoriser les chemins, les ports, les commandes docker compose).

Objectif : le même confort partout — un nom court, des sous-commandes identiques, et un dashboard global. Fini la mémoire : l’ordinateur se rappelle.

2. Ce qui a été créé

9 scripts exécutables dans ~/.local/bin (déjà sur le PATH — même endroit que misskey, idlezelus, ollama) :

ScriptServicePort(s)JournalType
strapiStrapi CMS (~/dev/strapi):1337/tmp/strapi.lognatif (npm, setsid + PID file)
ljLinux Journey (~/dev/linuxjourney):8080/tmp/lj.lognatif (uvicorn)
dartpadDartPad UI + API (/dev/dartpad-work):8899 + :8081/tmp/dartpad-ui.log + /tmp/dartpad-api.lognatif (python http + dart shelf)
peertubePeerTube (~/peertube):9000 · :1935docker compose logsdocker stack
jitsiJitsi Meet (~/jitsi/…-276801c):8443 · :8000docker compose logsdocker stack
rocketchatRocket.Chat (~/rocketchat-compose):3000docker compose logsdocker stack
matrixConduwuit + Element (~/dev/matrix):6167 + :8082docker compose logs / docker logs elementdocker (compose + run)
supabaseStack Supabase Glow Shop (~/Downloads/Glow Shop 221 cahier des charges/supabase):54321–:54327supabase logsCLI supabase start
servicesDashboard global——probe ports /dev/tcp

Chaque script accepte les mêmes sous-commandes : start|stop|restart|status|logs|open (les stacks docker acceptent aussi up/down). Les scripts natifs ont le pattern setsid … & + PID file dans /tmp + port probe /dev/tcp (ni ss, ni nc, ni netstat n’existent sur ce host — on sonde avec bash pur).

3. Le dashboard services

Une commande, tout le parc :

$ services
=== local services ===
strapi       DOWN       :1337      http://127.0.0.1:1337
lj           DOWN       :8080      http://127.0.0.1:8080
dartpad      DOWN       :8081+8899 http://127.0.0.1:8899/?channel=localhost
peertube     DOWN       :9000      http://localhost:9000
jitsi        DOWN       :8443      https://localhost:8443
rocketchat   DOWN       :3000      http://localhost:3000
matrix       DOWN       :6167+8082 http://localhost:8082
supabase     UP         :54321     http://127.0.0.1:54323
misskey      DOWN       :3000      http://localhost:3000
ollama       UP         :11434     http://localhost:11434

À la création : supabase UP, ollama UP (les deux seuls services encore en marche après le killing) et tous les arrêtés en DOWN — le dashboard reflète la réalité, vérifié depuis le sandbox qui partage le réseau de l’hôte. services status <nom> isole un service ; services start|stop|restart <nom> délègue au script du service.

4. Usage type

services                    # tout l'état en un coup d'œil
services start strapi       # équivalent de : strapi start
lj                          # Linux Journey démarre + ouvre le navigateur (xdg-open)
peertube up                 # docker compose up -d, puis ouvre http://localhost:9000
peertube down               # docker compose down
matrix                      # conduit (compose) + element (docker run si absent)
supabase status             # supabase status dans le projet Glow Shop
strapi logs                 # tail -f /tmp/strapi.log

Détails d’implémentation glanés sur le terrain : jitsi a son compose dans un sous-dossier (~/jitsi/jitsi-docker-jitsi-meet-276801c), rocketchat a plusieurs fichiers compose (le script utilise le défaut compose.yml), element n’a qu’un config.json → le script fait docker run -d --name element -p 8082:80 -v config.json s’il n’existe pas encore, supabase préfère le binaire supabase puis retombe sur npx supabase@latest.

5. Contraintes connues (honnêteté)

  1. Sandbox sans docker — les scripts peertube, jitsi, rocketchat, matrix, supabase ont été écrits dans le sandbox mais exécutés sur le terminal hôte (le sandbox n’a ni socket, ni binaire docker). Syntaxe vérifiée (bash -n sur les 9), logique docker non rejouée ici — à confirmer au premier up.
  2. Ports en conflit — :3000 est partagé par fCC API, Library app, Rocket.Chat et Misskey : un seul à la fois. :8082 = Element. Le dashboard dira UP mais l’app peut rester muette (cf. Rocket.Chat sans MongoDB).
  3. fcc / odin intacts — déjà en une commande via ~/.bashrc, pas de script dupliqué. misskey et idlezelus non modifiés (ils suivent déjà ce pattern).
  4. Les scripts natifs tuent par PID + pkill de secours — strapi develop et server.dart spawnent des enfants ; le stop tue le PID du fichier puis purge les orphelins par motif.

6. Registre mis à jour

Local Services.md a été mis à jour : nouvelle section « One-command launchers », statuts réels des services (tous les tués passent en down (killed 2026-09-19)), nouvelles lignes pour Strapi / Jitsi / Rocket.Chat / Matrix / Supabase / Misskey / Ollama, et la note de conflits de ports enrichie (:3000 × 4).

7. Leçons en une ligne

  1. Une commande par service > dix chemins mémorisés — le pattern misskey/idlezelus (sous-commandes + PID file + probe) s’est généralisé sans friction.
  2. Sonder sans outils — pas de ss/nc/netstat : /dev/tcp en bash pur suffit pour un status honnête.
  3. Chaque service a sa quirk — compose en sous-dossier (jitsi), config.json seul (element), CLI vs compose (supabase) : rien ne s’invente, tout se découvre.
  4. Documenter au moment où on l’apprend — chaque détail glané pendant l’investigation est devenu une ligne du script ou du registre.