Ce guide vous aide à diagnostiquer rapidement l'origine d'un problème si votre site Node.js, hébergé sur l'infrastructure Infomaniak, ne fonctionne pas comme prévu.

Vérifier le statut de l'application

Depuis le dashboard de votre site Node.js, vous pouvez consulter l'état actuel de l’application :

• Actif : votre application fonctionne normalement.
• En cours de redémarrage : l'application redémarre, attendez quelques instants.
• Arrêtée ou En erreur : il y a un problème.

Dans le cas d’une erreur ou d’un arrêt :

• Cliquez sur « Lancer » ou « Redémarrer » l'application.
• Consultez immédiatement la console d'exécution pour identifier d’éventuelles erreurs techniques.

Lire la console d’exécution

La console affiche les messages d’erreur générés lors du lancement de votre application. Voici les erreurs fréquentes :

• Commande de lancement incorrecte : vérifiez que vous utilisez bien la bonne syntaxe (exemple : npm start, node app.js, etc.).
• Erreur dans le code source : il peut s'agir d'une exception non gérée, d’un module manquant ou d’un port incorrectement défini.

Vérifier les paramètres de l'application

Dans la section Paramètres avancés du site, assurez-vous que tous les réglages sont corrects :

• Dossier d'exécution : dossier dans lequel sont lancées les commandes build et start.
• Commande de construction (optionnelle) : par exemple npm run build si votre app en nécessite une.
• Commande de lancement : par exemple node index.js, npm start, etc.
• Port d’écoute : le port sur lequel l’application attend les requêtes (par exemple 8080, 3000, etc.).
  • Le port configuré dans votre application doit correspondre à celui défini dans le Manager.
• Version de Node.js : assurez-vous qu’elle est compatible avec votre code.

Infomaniak met à disposition les gestionnaires de paquets NPM et Yarn. Vous pouvez choisir celui qui correspond à votre projet dans l’assistant de configuration.

Toujours bloqué ?

Le site reste inaccessible ?

• Votre application est peut-être en mode maintenance.
• Le port d’écoute de l’application peut être incorrect ou bloqué.
• L’application ne renvoie pas de réponse HTTP correcte (pas de res.send() ou res.end() dans votre serveur par exemple).

Vous avez utilisé une méthode avancée d’installation ?

Si vous avez importé votre code via Git, ZIP, SSH ou SFTP, assurez-vous que :

• Le code a bien été décompressé ou cloné dans le bon dossier.
• Les fichiers essentiels (package.json, server.js, index.js, etc.) sont présents.
• Les dépendances sont bien installées (node_modules présent après npm install ou yarn install).

Si le problème persiste après toutes ces vérifications :

• Essayez de créer un nouveau site avec la méthode simple pour tester avec un exemple fonctionnel.
• Comparez votre configuration avec celle de l’exemple fourni.
• Prenez connaissance de la documentation officielle de Node.js pour des erreurs spécifiques.
• En cas de besoin, contactez le support Infomaniak avec une copie des logs affichés dans la console.