How to set the Node.js version

Set the Node.js version per application on TurboStack with nodejs_version in the GUI or YAML, then verify and restart the app.

Each application chooses its own Node.js major version. Set it when you deploy an app, or when you move an existing app to a newer runtime.

Set it in the GUI

Open the host and select the application.
Go to Configure application > Technologies > NodeJS.
Choose the version.

The NodeJS panel on an application's Technologies tab, enabled, with the version selector that accepts a main version or a subversion

Set it in YAML

Set nodejs_version on the application (vhost) to the major version, as a quoted string. This key on its own installs the runtime. See Configure Node.js for the full set of keys.

nodejs_version: "24"

Publish the change to apply it.

Verify and restart

Over SSH, confirm the runtime:

node -v

Then restart your application so it runs on the new version - see Keep a Node.js app running. Long-running Node processes keep using the old runtime until they are restarted.

Tip

Match the version to your app's engines field in package.json, and test on a staging copy before switching a production site.

How to set the Node.js version

Set it in the GUI

Set it in YAML

Verify and restart

Tip

Related

See also