Local machine
Install the N|Solid Runtime on your development machine and connect it to N|Solid SaaS. Instructions are provided for Linux, macOS, and Windows.
Start at the NodeSource Downloads page and choose the Node.js LTS line you want. The examples on this page use the Node.js 24 (Krypton) LTS line.
- Linux
- macOS
- Windows
Install the runtime
The first time you install N|Solid, set up the NodeSource package repository for your distribution.
For Debian and Ubuntu (deb-based distributions):
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
For RHEL, Fedora, Amazon Linux, and other rpm-based distributions:
curl -fsSL https://rpm.nodesource.com/setup_24.x | sudo bash -
When the script finishes, it prints commands for both the nodejs and nsolid packages. Install nsolid. It provides the node and nsolid executables.
Then install the nsolid package. Run the same command later to update to the latest release.
On Debian and Ubuntu:
sudo apt-get install nsolid -y
On rpm-based distributions:
sudo dnf install nsolid -y
On older systems without dnf, use sudo yum install nsolid -y.
Use the N|Solid Runtime
The installer links the node executable to N|Solid, so you can run it as either node or nsolid. You can change the symbolic links it creates, but updates may overwrite your changes. Everything on your system that runs node now uses N|Solid. Until you configure it, the N|Solid Agent runs in passive mode, and N|Solid behaves the same as Node.js.
Check the installed versions:
node -vv # N|Solid Runtime version
node -v # Node.js version the runtime is based on
The output looks similar to this (your version numbers may differ):
v6.3.7
v24.21.0
nsolid -vv and nsolid -v print the same values.
Connect to N|Solid SaaS
Copy your N|Solid SaaS token from NodeSource Accounts, then configure the runtime with it. The quickest way is an environment variable. Set NSOLID_APPNAME as well, so your process has a recognizable name in the Console:
NSOLID_SAAS='<your-saas-token>' NSOLID_APPNAME=my-app nsolid index.js
Your process now appears in the N|Solid Console. For more options, see Runtime configuration.
Install the runtime
Download and run the pkg installer for your LTS line. N|Solid supports both Intel-based Macs and Apple silicon.
You can also install N|Solid with Homebrew. See the N|Solid Homebrew formula guide.
Use the N|Solid Runtime
The installer links the node executable to N|Solid, so you can run it as either node or nsolid. You can change the symbolic links it creates, but updates may overwrite your changes. Everything on your system that runs node now uses N|Solid. Until you configure it, the N|Solid Agent runs in passive mode, and N|Solid behaves the same as Node.js.
Check the installed versions:
node -vv # N|Solid Runtime version
node -v # Node.js version the runtime is based on
The output looks similar to this (your version numbers may differ):
v6.3.7
v24.21.0
nsolid -vv and nsolid -v print the same values.
Connect to N|Solid SaaS
Copy your N|Solid SaaS token from NodeSource Accounts, then configure the runtime with it. The quickest way is an environment variable. Set NSOLID_APPNAME as well, so your process has a recognizable name in the Console:
NSOLID_SAAS='<your-saas-token>' NSOLID_APPNAME=my-app nsolid index.js
Your process now appears in the N|Solid Console. For more options, see Runtime configuration.
Install the runtime
Download and run the Windows installer. Depending on whether Node.js is already installed, and which version, the installer may also install the prerequisites for running Node.js. Follow the suggestions in the installer prompts.
- Installer
- Location Selection
- Native Addon Option
- Native Installer Running
- Chocolatey Installer
Use the N|Solid Runtime
You can run N|Solid as either node or nsolid. Check the installed versions in PowerShell:
node -vv # N|Solid Runtime version
node -v # Node.js version the runtime is based on
The output looks similar to this (your version numbers may differ):
v6.3.7
v24.21.0
nsolid -vv and nsolid -v print the same values.
Connect to N|Solid SaaS
Copy your N|Solid SaaS token from NodeSource Accounts, then configure the runtime with it. The quickest way is an environment variable. Every node or nsolid process you start in the same PowerShell session connects to N|Solid SaaS:
$env:NSOLID_SAAS = '<your-saas-token>'
$env:NSOLID_APPNAME = 'my-app'
nsolid index.js
Your process now appears in the N|Solid Console. For more options, see Runtime configuration.
