This guide helps you quickly diagnose the cause of a problem if your Node.js site, hosted on the 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 moment.
• Stopped or Error: there is a problem.

In case of an error or interruption:

• Click "Start" or "Restart" the application.
• Check the execution console immediately to identify any technical errors.

Read the execution console

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

• Incorrect launch command: make sure you are using the correct syntax (e.g., npm start, node app.js, etc.).
• Error in the source code: this may be due to 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 that all settings are correct:

• Execution directory: the directory in which the build and start commands are executed.
• Build command (optional): for example, npm run build if your app requires one.
• Start command: for example, node index.js, npm start, etc.
• Listening port: the port on which the application listens for requests (e.g. 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 wizard.

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 imported your code via Git, ZIP, SSH, or SFTP, make sure that:

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

If the problem persists after all these checks:

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