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) :
| Script | Service | Port(s) | Journal | Type |
|---|---|---|---|---|
strapi | Strapi CMS (~/dev/strapi) | :1337 | /tmp/strapi.log | natif (npm, setsid + PID file) |
lj | Linux Journey (~/dev/linuxjourney) | :8080 | /tmp/lj.log | natif (uvicorn) |
dartpad | DartPad UI + API (/dev/dartpad-work) | :8899 + :8081 | /tmp/dartpad-ui.log + /tmp/dartpad-api.log | natif (python http + dart shelf) |
peertube | PeerTube (~/peertube) | :9000 · :1935 | docker compose logs | docker stack |
jitsi | Jitsi Meet (~/jitsi/…-276801c) | :8443 · :8000 | docker compose logs | docker stack |
rocketchat | Rocket.Chat (~/rocketchat-compose) | :3000 | docker compose logs | docker stack |
matrix | Conduwuit + Element (~/dev/matrix) | :6167 + :8082 | docker compose logs / docker logs element | docker (compose + run) |
supabase | Stack Supabase Glow Shop (~/Downloads/Glow Shop 221 cahier des charges/supabase) | :54321–:54327 | supabase logs | CLI supabase start |
services | Dashboard 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é)
- Sandbox sans docker — les scripts
peertube,jitsi,rocketchat,matrix,supabaseont é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 -nsur les 9), logique docker non rejouée ici — à confirmer au premierup. - Ports en conflit —
:3000est partagé par fCC API, Library app, Rocket.Chat et Misskey : un seul à la fois.:8082= Element. Le dashboard diraUPmais l’app peut rester muette (cf. Rocket.Chat sans MongoDB). fcc/odinintacts — déjà en une commande via~/.bashrc, pas de script dupliqué.misskeyetidlezelusnon modifiés (ils suivent déjà ce pattern).- Les scripts natifs tuent par PID +
pkillde secours —strapi developetserver.dartspawnent 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
- 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. - Sonder sans outils — pas de
ss/nc/netstat:/dev/tcpen bash pur suffit pour un status honnête. - 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.
- Documenter au moment où on l’apprend — chaque détail glané pendant l’investigation est devenu une ligne du script ou du registre.