Linux setup

In this step-by-step tutorial we will teach you how to setup your PenDAq on Linux.

The best way to get data from your PenDAq is using Node-RED which is an open source platform created by IBM and currently maintained by JS Foundation.
You can find more details about Node-RED here.


The following software package is required to run PenDAq with Node-RED in a Linux environment:

  • NodeJS 6.x

  • Libudev

  • Node-RED 0.16.x

  • PenDAq node

Step 1: installing NodeJS

The first step is to install NodeJS run-time (more details about NodeJS here).

Open your terminal and type the following two commands:

curl -sL | sudo -E bash -
sudo apt-get install -y nodejs

Before proceeding with the next steps check if NodeJS and npm were installed correctly. You can check it with the following commands:

node -v
npm -v 

Both commands should return a number with the installed version of node and npm.

Step 2: installing Libudev

The libudev tool is a dependence of the 'usb' NodeJS library and to install it run the following command:

sudo apt-get install build-essential libudev-dev

Step 3: installing Node-RED

Now that you already have NodeJS and npm it is time to install Node-RED (more details about Node-RED here). On your terminal type the following command:

sudo npm install -g --unsafe-perm node-red

Run Node-RED with: 

sudo node-red

This command will start the Node-RED application

Now open your preferred browser and type and the following address: 

You should see this web interface:

Step 4: installing PenDAq node

Once Node-RED is running you have to install a PenDAq node. On your Node-RED open the pallet manager.

In the pallet manager open the "install" tab, search for "pendaq" and install the "node-red-contrib-pendaq". Once the installation is ready click on "Done".

After clicking on "Done" and going back to the main screen you should be able see the "pendaq" node. Now drag and drop to the main tab the following nodes:

  • inject

  • pendaq

  • debug

then wire them as in the following image:

Click twice in the PenDAq node and select your device, change the amount of samples to 50, click on "Done" and then click on Deploy (at the up-right corner).

You are now ready to acquire data from your PenDAq. Open the "debug" tab (at the up-right corner) and then push the trigger button near by the timestamp node. You should see the data from Channel 1 in the debug tab.

Now you are ready to export those acquisitions to all outputs offered by Node-RED (websocket, TCP, UDP, Files, etc.)

Still have problems ?

Send us an email at