Strapi

  • Projet : Strapi (CMS headless) — exécution locale
  • Date : 2026-09-19
  • Statut : ✅ Terminé — Strapi tourne en local (admin créé, connexion vérifiée)
  • Objectif : Faire tourner Strapi en local sur http://localhost:1337 (panneau admin + API)

Contexte & contraintes

  • Machine : Fedora (Linux), utilisateur sambasene
  • Runtimes : Node v24.20.0, npm 11.19.0, yarn 11.21.0 présents
  • Pas de Docker / Podman → Strapi tourne en natif sur Node
  • Base de données : SQLite disponible (sqlite3) → défaut quickstart de Strapi (aucun serveur de BD requis)
  • Réseau : fonctionne, mais très lent vers registry.npmjs.org (5–140 s par requête) → toute l’installation prend du temps
  • Verrouillage npm : ~/.npmrc contient allow-scripts=netlify-cli,esbuild,unix-dgram,sharp (seuls ces paquets peuvent exécuter des scripts d’installation)
  • Emplacement de l’app : /home/sambasene/dev/strapi (schéma : toutes mes apps locales vivent dans ~/dev/)

Étapes chronologiques

Phase 1 — Génération du projet

cd /home/sambasene/dev
npx create-strapi-app@latest strapi --quickstart --no-run --use-npm

❌ Erreur 1 : même avec --quickstart, Strapi v5.54.0 affiche une invite interactive « Please log in or sign up » (connexion cloud). Sans TTY, il plante : ERR_USE_AFTER_CLOSE (readline was closed).

✅ Correctif : inspection des options CLI (create-strapi-app --help) → j’ai trouvé --skip-cloud et --non-interactive :

rm -rf strapi   # nettoyage du dossier partiel du lancement planté
npx create-strapi-app@latest strapi --quickstart --no-run --use-npm --skip-cloud --non-interactive

✅ Projet généré dans /home/sambasene/dev/strapi (Strapi v5.54.0, SQLite, JavaScript, package.json créé).

Phase 2 — Installation des dépendances

Le générateur a ensuite lancé lui-même npm install :

npm error code EALLOWSCRIPTS
npm error --allow-scripts is not allowed in project-scoped installs.
Add the entries to the "allowScripts" field in package.json, or to .npmrc, instead.

❌ Erreur 2 / cause racine : mon ~/.npmrc global active le verrouillage des scripts (fonction allow-scripts d’npm 11). Le générateur Strapi passe lui-même l’option --allow-scripts, interdite dans un projet par npm 11.19 → installation avortée.

✅ Correctif : je lance npm install directement dans le projet (le message d’erreur le dit d’ailleurs : « your project was created correctly … run npm install »).

cd /home/sambasene/dev/strapi
npm install

⚠️ L’installation a ensuite été tuée deux fois par les timeouts de ma session shell pendant les vérifications. La vraie contrainte en dessous : les requêtes vers le registre prennent 5–140 s chacune (« react-is 143872ms ») → la résolution d’environ 1 500 paquets est lente.

✅ Correctif :

  1. J’ai créé un .npmrc propre au projet (/home/sambasene/dev/strapi/.npmrc) pour que les modules natifs puissent exécuter leurs scripts de prébuild (better-sqlite3 en a besoin à l’exécution) :
    allow-scripts=better-sqlite3,sharp,esbuild,unix-dgram,netlify-cli
  2. J’ai relancé l’installation complètement détachée avec setsid pour qu’aucun timeout de shell ne puisse la tuer : setsid sh -c 'npm install >> /tmp/strapi-npm-install.log 2>&1'.

Phase 3 — Réparer le module natif, puis démarrer

❌ Erreur 4 / cause racine : avec la liste d’autorisation en place, les scripts d’installation se sont exécutés — et better-sqlite3@12.8.0 n’a pas de binaire précompilé pour Node 24 (ABI 137), donc il retombe sur une compilation source via node-gyp… et cette machine n’a aucun compilateur C (/usr/bin/clang introuvable, pas de gcc/make, et pas de sudo dans cet environnement) :

gyp ERR! configure error
gyp ERR! stack Error: `gyp` failed with exit code: 1
gyp ERR! System Linux 7.1.13-200.fc44.x86_64
FileNotFoundError: [Errno 2] No such file or directory: '/usr/bin/clang'

✅ Correctif : utiliser Node 22 LTS à la place — better-sqlite3 fournit des binaires précompilés pour son ABI (127), donc aucune compilation nécessaire. Installé dans l’espace utilisateur (sans sudo) : téléchargement de node-v22.23.2-linux-x64.tar.xz depuis nodejs.org, extraction dans ~/.local/opt/node22.

curl -o /tmp/node22.tar.xz https://nodejs.org/dist/latest-v22.x/node-v22.23.2-linux-x64.tar.xz
mkdir -p ~/.local/opt/node22
tar -xJf /tmp/node22.tar.xz --strip-components=1 -C ~/.local/opt/node22

Puis suppression du node_modules corrompu (deux échecs successifs avaient laissé un arbre incomplet — prebuild-install lui-même manquait de dépendances) et réinstallation avec Node 22 :

cd /home/sambasene/dev/strapi
rm -rf node_modules
PATH=/home/sambasene/.local/opt/node22/bin:$PATH npm install

✅ Installation terminée (EXIT=0, lockfile écrit, 856 paquets). Lien natif vérifié pour de vrai :

$ node -e "require('better-sqlite3')(':memory:')"
better-sqlite3 OK, sqlite 3.51.3

Phase 4 — Démarrage du serveur ✅

cd /home/sambasene/dev/strapi
PATH=/home/sambasene/.local/opt/node22/bin:$PATH npm run develop

Sortie réelle au démarrage :

✔ Compiling TS (2831ms)

 Project information
╭────────────────────┬──────────────────────────────────────────────────╮
│ Time               │ Sat Sep 19 2026 11:03:07 GMT+0000 (Greenwich Mean Time) │
│ Launched in        │ 7642 ms                                          │
│ Environment        │ development                                      │
│ Process PID        │ 15564                                            │
│ Version            │ 5.54.0 (node v22.23.2)                           │
│ Plan               │ Community                                        │
│ Database           │ sqlite                                           │
│ Database name      │ .tmp/data.db                                     │
╰────────────────────┴──────────────────────────────────────────────────╯
[2026-09-19 11:03:07.665] info: Strapi started successfully

Vérification :

$ curl -s -o /dev/null -w "%{http_code}" http://localhost:1337/    → 302 (→/admin)
$ curl -s -X POST http://localhost:1337/admin/register-admin -H "Content-Type: application/json" \
    -d '{"firstname":"Samba","lastname":"Sene","email":"admin@strapi.local","password":"Strapi2026!Local"}'
  → HTTP 200 (49 s au premier appel, pendant la compilation du panneau admin)
$ curl -s -X POST http://localhost:1337/admin/login -H "Content-Type: application/json" \
    -d '{"email":"admin@strapi.local","password":"Strapi2026!Local"}'
  → HTTP 200, jeton JWT renvoyé  ✅ connexion fonctionnelle

Tableau d’état

QuoiStatutPriorité
Projet généré (v5.54.0, SQLite, JS)✅ fait—
Dépendances installées (Node 22, npm)✅ fait — 856 paquets, lockfile écrit—
Module natif better-sqlite3✅ binaire précompilé, sqlite 3.51.3 testé—
Serveur sur http://localhost:1337✅ en cours (PID 15564)—
Panneau admin✅ http://localhost:1337/admin—
Premier utilisateur admin✅ créé — connexion vérifiée (JWT 200)—

Tableau identifiants / config

ÉlémentValeurNote
Chemin de l’app/home/sambasene/dev/strapi
URL adminhttp://localhost:1337/admin
RuntimeNode v22.23.2 dans ~/.local/opt/node22/binle Node 24 système échoue sur better-sqlite3
Base de donnéesFichier SQLite /.tmp/data.dbdéfaut quickstart
Email adminadmin@strapi.localcréé le 2026-09-19
Mot de passe adminStrapi2026!Local⚠️ à changer si exposé au-delà de localhost
PID serveur15564kill 15564 pour arrêter

Commandes de redémarrage

cd /home/sambasene/dev/strapi
PATH=/home/sambasene/.local/opt/node22/bin:$PATH npm run develop   # démarrer (détacher avec setsid ... &)
kill 15564                                                          # arrêter

Bloc de configuration réutilisable

/home/sambasene/dev/strapi/.npmrc (portée projet uniquement — ne touche PAS au verrouillage global) :

allow-scripts=better-sqlite3,sharp,esbuild,unix-dgram,netlify-cli

Leçons apprises (jusqu’ici)

  1. Strapi v5 demande toujours une connexion cloud à la génération — même avec --quickstart. Toujours ajouter --skip-cloud --non-interactive.
  2. npm 11.19 interdit --allow-scripts dans un projet — l’erreur est fatale (EALLOWSCRIPTS). Solution : lancer npm install soi-même, ou écrire la liste d’autorisation dans un .npmrc de projet / package.json.
  3. Les installations longues meurent quand la session shell expire — lancer avec setsid ... > log 2>&1 & et surveiller le log ; ne jamais bloquer la session.
  4. Le registre npm peut être très lent ici (100 s+ par requête de métadonnées) : patience + --prefer-offline au relancement ; ne jamais conclure que l’installation est bloquée.
  5. Les modules natifs s’installent silencieusement sans leur binaire quand les scripts sont bloqués (better-sqlite3) — ils doivent être dans la liste d’autorisation AVANT l’exécution.
  6. better-sqlite3 12.8.0 n’a pas de prébuild pour Node 24 → il faut un compilateur C, absent de cette machine (et pas de sudo ici). Un Node 22 LTS de secours a tout réglé — pas de compilation, pas de root.
  7. Un npm install raté laisse un arbre corrompu — ne pas rapiécer, rm -rf node_modules puis réinstaller (le cache est chaud, c’est rapide la 2ᵉ fois).
  8. Les tâches setsid/détachées héritent du cwd du shell — toujours faire cd dans le projet au sein de la commande détachée, sinon npm cherche package.json au mauvais endroit.
  9. La première requête après le boot compile le panneau admin (/admin/register-admin a pris 49 s) — un premier appel lent est normal, pas un blocage.

État final vérifié le 2026-09-19 : serveur démarré, utilisateur admin créé, connexion JWT renvoyée en HTTP 200.