- 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, npm11.19.0, yarn11.21.0pré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 :
~/.npmrccontientallow-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 :
- J’ai créé un
.npmrcpropre 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 - J’ai relancé l’installation complètement détachée avec
setsidpour 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
| Quoi | Statut | Priorité |
|---|---|---|
| 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ément | Valeur | Note |
|---|---|---|
| Chemin de l’app | /home/sambasene/dev/strapi | |
| URL admin | http://localhost:1337/admin | |
| Runtime | Node v22.23.2 dans ~/.local/opt/node22/bin | le Node 24 système échoue sur better-sqlite3 |
| Base de données | Fichier SQLite /.tmp/data.db | défaut quickstart |
| Email admin | admin@strapi.local | créé le 2026-09-19 |
| Mot de passe admin | Strapi2026!Local | ⚠️ à changer si exposé au-delà de localhost |
| PID serveur | 15564 | kill 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)
- Strapi v5 demande toujours une connexion cloud à la génération — même
avec
--quickstart. Toujours ajouter--skip-cloud --non-interactive. - npm 11.19 interdit
--allow-scriptsdans un projet — l’erreur est fatale (EALLOWSCRIPTS). Solution : lancernpm installsoi-même, ou écrire la liste d’autorisation dans un.npmrcde projet /package.json. - Les installations longues meurent quand la session shell expire —
lancer avec
setsid ... > log 2>&1 &et surveiller le log ; ne jamais bloquer la session. - Le registre npm peut être très lent ici (100 s+ par requête de métadonnées) :
patience +
--prefer-offlineau relancement ; ne jamais conclure que l’installation est bloquée. - 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. better-sqlite312.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.- Un
npm installraté laisse un arbre corrompu — ne pas rapiécer,rm -rf node_modulespuis réinstaller (le cache est chaud, c’est rapide la 2ᵉ fois). - Les tâches
setsid/détachées héritent du cwd du shell — toujours fairecddans le projet au sein de la commande détachée, sinon npm cherchepackage.jsonau mauvais endroit. - La première requête après le boot compile le panneau admin
(
/admin/register-admina 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.