VTS-VTSD is HTTP server for surface and map configuration delivery.
Download, build and install
You basically need just 2 steps to get VTS-VTSD installed:
git clone the
source code from the repository and
make it. But there are some tricky parts
of the process, so read carefully following compilation howto.
Make sure, you have
g++ installed, before you try to compile
sudo apt-get update sudo apt-get install cmake g++
git clone https://www.graphics.rwth-aachen.de:9000/OpenMesh/OpenMesh.git cd OpenMesh mkdir build cd build cmake .. make -j4 sudo make install
Adding UbuntuGIS repo
sudo add-apt-repository ppa:ubuntugis/ubuntugis-unstable sudo apt-get update
Installing packaged dependencies
Now we can download and install rest of the dependencies, which are needed to get VTS-VTSD compiled:
sudo apt-get install \ libboost-dev \ libboost-thread-dev \ libboost-program-options-dev \ libboost-filesystem-dev \ libboost-regex-dev \ libboost-iostreams-dev\ libboost-python-dev \ libopencv-dev libopencv-core-dev libopencv-highgui-dev \ libopencv-photo-dev libopencv-imgproc-dev libeigen3-dev libgdal-dev \ libproj-dev libgeographic-dev libjsoncpp-dev \ libprotobuf-dev protobuf-compiler libprocps-dev libmagic-dev gawk sqlite3
Clone and Download
The source code can be downloaded from
GitHub repository, but since there are
external dependences, you have to use
--recursive switch while cloning the
git clone --recursive https://github.com/Melown/vts-vtsd.git
NOTE: If you did clone from GitHub previously without the
parameter, you should probably delete the
vts-vtsd directory and clone
again. The build will not work otherwise.
Configure and build
For building VTS-VTSD, you just have to use
cd vtsd make -j4 # to compile in 4 threads
Default target location (for later
make install) is
You can set the
CMAKE_INSTALL_PREFIX variable, to change it:
make set-variable VARIABLE=CMAKE_INSTALL_PREFIX=/install/prefix
You should see compilation progress. Depends, how many threads you allowed for
the compilation (the
-jNUMBER parameter) it might take couple of minutes to an
hour of compilation time.
The binaries are then stored in
bin directory. Development libraries are
You should be able to call
make install, which will install to either defaul
/usr/local/ or to directory defined previously by the
CMAKE_INSTALL_PREFIX variable (see previous part).
When you specify the
DESTDIR variable, resulting files will be saved in
$DESTDIR/$CMAKE_INSTALL_PREFIX directory (this is useful for packaging), e.g.
make install DESTDIR=/home/user/tmp/
Install from Melown repository
We provide precompiled packages for some popular linux distributions. See Melown OSS package repository for more information. This repository contains all needed packages to run VTS OSS software.
Run VTS-VTSD server
First you need to create
vtsd.conf configuration file. You then can run
vtsd --help vtsd --config vtsd.conf
NOTE: You might need to add also
--registry parameter, and point it to
previously compiled VTS-Registry.
Description of the configuration file can be found in our user documentation.
The server is not intended to be exposed to the Internet as it is, instead it's advised to hide it behind e.g. NGINX server.
How to contribute
Check the CONTRIBUTING.md file.