Skip to main content
Version: 6.0.0

Local Machine

Getting N|Solid working on your local development machine.

Start by visiting the NodeSource Downloads Page and follow the options for your preferred Node.js LTS line.

Installing the Runtime


In this example, I'm choosing the Node.js 20 Iron LTS line.

Screenshot of Node.js 20 Iron LTS instructions

The first time, you'll need to set up the repository on your system:

$ curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
[sudo] password for bryce:
2024-05-28 17:29:11 - Installing pre-requisites
Get:1 https://deb.nodesource.com/node_20.x nodistro InRelease [12.1 kB]
...
Reading package lists... Done
2024-05-28 17:29:18 - Repository configured successfully. To install Node.js, run: apt-get install nodejs -y

Once the repository is set up, you can install or update it via apt-get:

$ sudo apt-get install nsolid -y
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
The following packages will be upgraded:
nsolid
1 upgraded, 0 newly installed, 0 to remove and 2 not upgraded.
...
Unpacking nsolid (20.13.1-ns5.2.2) over (20.13.1-ns5.2.1) ...
Setting up nsolid (20.13.1-ns5.2.2) ...
...

You can see that in my case above, it updated an existing install of N|Solid to the latest release.

Using the N|Solid Runtime


When installed, N|Solid will alias the node executable on your system to itself, so it can be run by either using node or nsolid. This can be customized by changing the symlinks it creates, but updating may overwrite your changes. Everywhere on your system using node will now be using nsolid--though without configuration the N|Solid Agent will be running in passive mode and there should be no discernable difference.

$ node -vv  # outputs the N|Solid Runtime version
v5.2.2
$ node -v # outputs the Node.js Runtime basis
v20.13.1
$ nsolid -vv
v5.2.2
$ nsolid -v
v20.13.1

Connecting to N|Solid SaaS


Once the runtime is installed, you can get your N|Solid SaaS connection string from NodeSource Accounts and configure it using your preferred method to send data to your N|Solid SaaS server. Here I'm using a simple environment variable approach:

$ NSOLID_SAAS='... my NSOLID_SAAS key from NodeSource Accounts ...' node index.js

And now my process shows up in my N|Solid Pro UI. For additional configuration options check out the section on Runtime Configuration.