This guide helps you quickly diagnose the cause of a problem if your Node.js site, hosted on Infomaniak infrastructure, is not working as expected.

Check the application status

From the dashboard of your Node.js site, you can view the current status of the application:

• Active : your application is running normally.
• Restarting : the application is restarting, please wait a few moments.
• Stopped or In error : there is a problem.

In case of an error or a stop:

• Click on "Start" or "Restart" the application.
• Immediately check the execution console to identify any technical errors.

Read the execution console

The console displays error messages generated when launching your application. Here are the common errors:

• Incorrect launch command : check that you are using the correct syntax (example: npm start, node app.js, etc.).
• Error in the source code : this could be an unhandled exception, a missing module, or an incorrectly defined port.

Check the application settings

In the Advanced Settings section of the site, make sure all settings are correct:

• Execution folder : folder in which the build and start commands are launched.
• Build command (optional) : for example npm run build if your app requires one.
• Launch command : for example node index.js, npm start, etc.
• Listening port : the port on which the application waits for requests (for example 8080, 3000, etc.).
  • The port configured in your application must match the one defined in the Manager.
• Node.js version : make sure it is compatible with your code.

Infomaniak provides the NPM and Yarn package managers. You can choose the one that suits your project in the configuration assistant.

Still stuck?

Is the site still inaccessible?

• Your application may be in maintenance mode.
• The application's listening port may be incorrect or blocked.
• The application does not return a correct HTTP response (e.g., no res.send() or res.end() in your server).

Did you use an advanced installation method?

If you have imported your code via Git, ZIP, SSH, or SFTP, make sure that:

• The code has been correctly decompressed or cloned into the right folder.
• The essential files (package.json, server.js, index.js, etc.) are present.
• The dependencies are correctly installed (node_modules present after npm install or yarn install).

If the problem persists after all these checks:

• Try creating a new site using the simple method to test with a working example.
• Compare your configuration with the provided example.
• Refer to the official Node.js documentation for specific errors.
• If needed, contact Infomaniak support with a copy of the logs displayed in the console.