Problèmes de Service (Systemd / Node.js)

Cette page traite des problèmes liés au démarrage et à l'exécution du processus en arrière-plan de CoreSight.

Le service est "inactive (dead)" ou "failed"

Vérifiez les logs avec journalctl -u coresight -n 50.

Erreur : Cannot find module 'better-sqlite3-multiple-ciphers' ou MODULE_NOT_FOUND

Cette erreur se produit si les dépendances natives Node.js n'ont pas été compilées pour la bonne architecture cible lors de la création de la release, ou si le dossier node_modules est incomplet.

Solution :

1. Assurez-vous d'utiliser une archive de release officielle générée par le script build-release.sh.
2. Réinstallez l'application en écrasant les fichiers défectueux : exécutez à nouveau le script install.sh ou update.sh.

Erreur : Error: listen EADDRINUSE :::443

Le port 443 est déjà occupé par une autre application (par exemple, un serveur Apache ou Nginx déjà installé sur la machine).

Solution :

1. Identifiez le processus qui utilise le port :

   sudo fuser 443/tcp
   # ou
   sudo lsof -i :443

2. Si c'est un processus inutile, arrêtez-le et désactivez-le.
3. Si vous avez un Apache existant (ex: pour wiki.coresightsec.com), assurez-vous que CoreSight écoute sur un autre port (ex: 5174 via PORT=5174 dans .env) et utilisez Apache comme reverse proxy vers CoreSight.

Le service redémarre en boucle (Looping)

Si le service redémarre constamment, il y a probablement une erreur critique au démarrage qui fait crasher le script server/index.js (par exemple, une erreur de syntaxe dans .env ou une base de données corrompue). Vérifiez minutieusement les premières lignes du log d'erreur après un redémarrage.