Skip to content

JavaScript/Node.js Application FAQ

How to upload a Node.js application

To upload a Node.js application, pack your code into a zip archive. Make sure the archive contains a package.json file — this is how the system identifies your project as a Node.js application.

Important

The archive must contain exactly one package.json file. If there are multiple or none — the system won't be able to recognize the project as a Node.js application.

How to choose a Node.js version

When uploading your application, you can choose the desired Node.js version on the second step. Available versions:

Version Description
latest Latest available version (default)
24 Node.js 24
23 Node.js 23
22 Node.js 22 (LTS)
21 Node.js 21
20 Node.js 20 (LTS)
19 Node.js 19
18 Node.js 18 (LTS)
17 Node.js 17
16 Node.js 16
15 Node.js 15
14 Node.js 14
12 Node.js 12

How to install npm packages

By default, the system runs npm install to install dependencies from your package.json. If you need a different command to install packages (e.g., yarn install), you can change it on the second step of the upload process in the "Package install command" field.

If you need to install additional system packages or run custom commands before the build, use the deployf-install.sh file, more details here.

How to change the run command

The run command is determined automatically based on the contents of package.json (see below). You can change it on the second step of the upload process in the "Run command" field.

Example run commands:

node index.js
node src/app.js
npm start

How the application entry point is determined

The system determines the Node.js application entry point in the following order:

  1. main field in package.json — standard Node.js entry point.
  2. scripts.start script — if it contains a command like node <file>, the file path is extracted.
  3. Fallback — if none of the above are found, index.js is used.

Example package.json:

{
  "name": "my-app",
  "main": "src/app.js",
  "scripts": {
    "start": "node src/app.js"
  }
}

Didn't find an answer?

Still have questions? Ask us in the Telegram support chat