imbra - How to Fix Node.js Application Not Starting in iPanel

Troubleshoot a Node.js application that fails to start or crashes immediately after starting.

Steps

  1. In iPanel, navigate to your website management page and click the Log Viewer tab.

    [screenshot: log viewer tab]

  2. Click the Output Log tab (Terminal icon) to see your application's stdout and stderr output.

    [screenshot: output log tab]

  3. Check the App Error Log tab (Bug icon) for application-specific errors.

    [screenshot: app error log tab]

  4. Common issues: missing node_modules — run npm install from the Node.js tab.

    [screenshot: running npm install]

  5. Check that the correct Node.js version is selected for your application in the website settings.

    [screenshot: checking Node.js version]

  6. Verify your entry point file (e.g., app.js, server.js, index.js) is correctly configured.

    [screenshot: checking entry point configuration]

  7. Try restarting the application from the website management page.

    [screenshot: restarting application]

Tip: Check that your app listens on the port provided by the environment variable, not a hardcoded port.

Related Articles