Installing Node.js

Node.js requirements

• Access to Node.js repositories via HTTPS.
• The Nginx web server is installed.

Node.js installation

1. Log in to ispmanager with superuser permissions.
2. Go to the Software configuration section.
3. Select Node.js.
4. Click on the toolbar.
5. Confirm the installation.
6. Wait for the installation to complete.

After installation, the panel will:

• connect the Node.js repository
• install npm and the latest LTS version of Node.js
• install pm2 to manage running projects

Next, proceed to user setup.

User setup

To enable a user to work with Node.js projects, enable the following options in their user settings:

• Access to Node.js

• Node.js version by default

  These options can be used when creating user templates.

Users with the ability to use Node.js are marked with the icon in the Settings column.

This option can be dasibled if the user doesn't have any Node.js-enabled sites.

Uninstalling Node.js

To uninstall Node.js:

1. Log in to ispmanager with superuser permissions.
2. Go to the Software configuration section.
3. Select Node.js from the list.
4. On the toolbar, click .
5. On the Settings page, uncheck Node.js.
6. Click Save.

The control panel will uninstall Node.js and related software — npm, pm2.

Node.js technical details

When installing Node.js, the panel downloads the ispmanager-pkg-nodejs package.

Node.js service directories

To ensure proper project operation, utility directories are created in the user directory:

• /var/www/USERNAME_data/.npm/ — npm package manager data
• /var/www/USERNAME_data/.nvm/ — installed Node.js versions
• /var/www/USERNAME/data/.pm2/ — pm2 process manager data

If you delete these directories, they will be recreated the next time you edit the site, though npm and pm2 may not function properly.

Node.js log

Select a project in the Sites section → click → in the context menu, click Log.

List of logs:

• PROJECT_NAME-error.log — a file containing startup commands errors
• PROJECT_NAME-install.log — a file containing the results of reading package.json and installing dependencies
• PROJECT_NAME-out.log — a file containing the output of the new command and its entry in the Select a command from the list of available commands
• PROJECT_NAME.access.log — a file containing information about the devices which the project was opened on
• PROJECT_NAME.error.log — a file containing projects launch errors