Creating a new Node.js project

Add your Node.js project in one of the following ways:

• create and upload it separately from the website
• add it to an existing website

Creating a separate project

1. Log in to ispmanager with your account.
2. Go to the Sites section.
3. On the toolbar, click Create site → Node.js project.
4. Fill in the information:
   • Domain name — the name of the new website or project. Example: example.com
   • Site owner — the user who owns the project. Available to reseller-level accounts or above.
   • Node.js version — Node.js versions from 12.13.0 to 26.2.0
   • Connection method:

     • Socket file — connecting and running a project via a Unix socket

       Details

       To run Node.js over a Unix socket, the directory /var/www/USERNAME/data/nodejs/ will be created.

       To pass settings to the Node.js server file, use the SOCKET environment variable and its value.

     • Port — connecting and running a project via a free, unprivileged TCP port

       Details

       ispmanager will automatically select a free TCP port for Node.js. The search for a free port starts with the value specified in the NodeJsBackendBind parameter of the ispmanager configuration file. The default value is 127.0.0.1:10000.

       To pass settings to the Node.js server file, use the PORT environment variable and its value.

   • Method of project creation:
     • Upload the application code — a package.json file with packages and dependencies for running the project
       • Code loading method:
         • Upload from a local directory — files are uploaded only from the project owner's directory. Directory selection is available if the user has file read permissions.
           • Path to the directory — the path to the project folder from the project owner's directory. Directory: /var/www/USER/data
         • Upload from a local computer — a file from a folder on your computer
           • Select file — select a file or drag it from a folder on your computer into the panel
     • Run an empty project — a project with a package.json file without dependencies. Edit the file if necessary after creating the project
5. Click Create.

After the file is uploaded, the panel will automatically read it and, if successful, install the dependencies. If an error occurs, a notification will appear stating "Installation of Node.js dependencies completed with errors." To view the error log, click Details in the notification or in the Sites section.

Next, configure the project run settings.

Adding a project to the site

1. Log in to ispmanager with your account.
2. Go to the Sites section.
3. Create or Edit an existing site.
4. In the site settings, specify:

   • Handler — Node.js

     When selecting the Node.js handler, installing a CMS or website builder is not available.

   • Node.js version — Node.js versions from 12.13.0 to 26.2.0
   • Connection method:

     • Socket file — connecting and running a project via a Unix socket

       Details

       To run Node.js over a Unix socket, the directory /var/www/USERNAME/data/nodejs/ will be created.

       To pass settings to the Node.js server file, use the SOCKET environment variable and its value.

     • Port — connecting and running a project via a free, unprivileged TCP port

       Details

       ispmanager will automatically select a free TCP port for Node.js. The search for a free port starts with the value specified in the NodeJsBackendBind parameter of the ispmanager configuration file. The default value is 127.0.0.1:10000.

       To pass settings to the Node.js server file, use the PORT environment variable and its value.

5. Save the changes.
6. Select a site → click.
7. Click Run settings (Node.js).
8. Set the required startup commands.
9. Click Save and restart.

After the first deployment of the project, dependencies from the package.json file will be automatically installed.