User Tools

Site Tools


The VSCP Server



Server/Service Discovery





TCP/IP Interface

TCP/IP Protocol Description










Websocket Commands


REST interface

Decision Matrix




Level I Drivers

Level II Drivers


Other documentation


Setting up the system on Unix

To install VSCP & Friends on Unix you need to build the system from source. The build process is simple and it usually don't give any problems. All packages are available for download at Sourceforge. Download the .zip or the .tgz archives of the package.

The build process is described in the file BUILD_UNIX in the root of the source folder. You find the source in the same folder as the installation packages. The source for the system is also available on GitHub if you want to use unstable code or just prefers GitHub for some other reason.

A sample configuration file for Unix is here.

Getting VSCP & Friends working on a Debian system

Until we have a deb installation this is the steps to do to have vscp & friends working on a Debian system.

Your machine need to be connected to the Internet for this to work and you need to become root

su -

or if you are on an Ubuntu system add


in front of the commands below or issue

sudo -i  

to stay as the root user.

Step 1

If you don't have a build environment on your system follow the steps on this page. Make (below) will complain if you don't. Or just issue

apt-get update && apt-get upgrade
apt-get install build-essential

If you are in a real hurry (or can't read) do

apt-get install git build-essential libwxbase3.0-dev  libssl-dev libpcap0.8-dev libcurl4-openssl-dev libpcap-dev 

and then

git clone

and go to step 10

Step 2


apt-get install libwxbase3.0-dev

or (only if version 3 is not available )

apt-get install libwxbase2.8-dev  

or if you want graphics support (VSCP Works builds)

apt-get install libwxgtk3.0-dev

or (only if version 3 is not available )

apt-get install libwxgtk2.8-dev 

Building GTK versions will build VSCP Works and other graphical components.

If you want wxWidgets 3.0 on Raspberry Pi read note here.

Step 3

apt-get install libssl-dev libpcap0.8-dev libcurl4-openssl-dev

Step 4

If you want to get the source from GitHub you may want to install Git.

apt-get install git

Step 5 (optional)

If you want MQTT driver support (recommended). You need to install Mosquitto. Se Installing mosquitto for use with VSCP for instructions.

The installation only affect the build of the MQTT driver so if you don't need that driver you can skip this step.

Step 6 (optional)

If you want rawethernet support (recommended).

apt-get install libpcap-dev

The installation only affect the build of the raw ethernet driver so if you don't need that driver you can skip this step.

Step 7 (optional)

If you want LUA scripting support (recommended).

apt-get install lua5.2 lua5.2-dev

Step 8 (optional)

If you want SQLite3 database support (recommended).

apt-get install libsqlite3-0 libsqlite3-dev 

Step 9

Normally you should consider working with one of the stable releases. All packages are available for download at Sourceforge. Download the .zip or the .tgz archives of the package.

You unpack the tgz with

tar -zxvf vscp_src_0.4.0.11.tgz

You unzip the with


As an alternative you can get the source from Github (need to gave Git installed as of above). If you get head software here you get the latest software but beware it can be unstable. If you clock releases you can fins stable software here as well.

git clone

This takes time on slower machines (like Raspberry Pi). Especially “Compressing objects” and “Resolving deltas”. Go for a long walk meanwhile.

An other alternative way is to get the source is to download the zip file from and unpack it on your system.

Do this with


Then unpack the archive with


There is a scripts that can be used to do these steps automagically for you

chmod a+x fetch_master
sudo ./fetchmaster

will fetch the latest code, build it and install it for you.

or add this to a a file

sudo rm -rf vscp_software-master
sudo wget  /
sudo unzip
sudo rm -rf
cd vscp_software-master
sudo ./configure
sudo make

make it executable with

chmod a+x 'filename'

and the run the file.

Step 10

cd vscp

Step 11

./configure --enable-ssl

Step 12


To make sure everything build OK you can issue make again and check the output for errors. You don't get bombarded with such masses of text on the second run.

If you did skip the MQTT installation you will get some complaints when the MQTT driver is compiled. This is nothing to worry about if you don't plan to use it. The same is true for other parts you skip as well

It can be hard to see errors in all the text that is output by the build process. If you use

make | grep error

it is much easier so see possible errors during the build process.

Step 13

make install

Instead of first doing make and then make install you can of course do make install directly.

make config

installs the default configuration files. Can always be used to restore them also.

 make web-files

installs (or restores) web demo content including websocket examples.

You can use

make force-conf

which will install all configuration files including web package without asking any questions. DANGEROUS if you have edited configuration files. GOOD if you want to restore a system.

Step 14

You can now remove the source packages if your want.

After doing this you can set up a working VSCP & Friends system.

Step 15

Now reboot and the daemon will run. or issu

/init.d/vscpd start

to start the server.

It is also possible to run the daemon as any other program with

/usr/local/bin/vscpd -s

this is probably the best test to do on a newly installed system to see that the daemon starts properly as error messages will be shown in the terminal windows in this mode. Terminate the daemon with ctrl+c

Default install directory is /usr/local/bin

Step 16

Not taking your newly installed system for a test ride
Take VSCP & Friends for a test ride


Build wxWidgets 2.8.12


./configure –disable-gui –enable-unicode

Disable GUI only for non GUI builds. Add –enable-debug for debug builds.

Build wxWidgets 3.0.2

./configure --disable-gui

Disable GUI only for non GUI builds.

apt-get install libgtk2.0-dev

is needed for graphical builds.


If you want to know which version of wxWidgets you have installed

wx-config --version

If you want to know which packages are installed

dpkg --get-selections

Build statically

./configure --enable-unicode --disable-shared --disable-gui

Grodans Paradis AB

setting_up_the_system_on_unix.txt · Last modified: 2017/10/13 18:11 by admin