Manual compilation and installation¶

Currently manual method of installation is considered to be the easiest way to get newest version of gr-gsm up and running. The gr-gsm repository contains automatic tests of manual installation in form of [dockerfiles](https://github.com/ptrkrysik/gr-gsm/tree/development/tests/dockerfiles) that are built and executed by [Travis CI](https://travis-ci.org/ptrkrysik/gr-gsm/builds) continuous integration service. Travis CI informs if particular revision of gr-gsm builds and passes tests on a set of GNU/Linux distributions. History of the results can be checked on [the gr-gsm's Travis CI page](https://travis-ci.org/ptrkrysik/gr-gsm/builds).

The instructions presented here are a version of [dockerfiles](https://github.com/ptrkrysik/gr-gsm/tree/development/tests/dockerfiles) with stripped instructions specific to docker and without running unit tests. This wiki might at some moment be behind installation procedures contained in the [dockerfiles](https://github.com/ptrkrysik/gr-gsm/tree/development/tests/dockerfiles) so in case of installation problems it is a good idea to look in there.

Debbian-based distributions (Debian Testing, Ubuntu >=16.04, Kali Rolling Edition)¶

First install all needed prerequisites with following command:

apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -y \
    cmake \
    autoconf \
    libtool \
    pkg-config \
    build-essential \
    python-docutils \
    libcppunit-dev \
    swig \
    doxygen \
    liblog4cpp5-dev \
    python-scipy \
    gnuradio-dev \
    gr-osmosdr \
    libosmocore-dev

Currently on Debian Testing and Kali Rolling execution of following command is needed:

 sudo ln -sf /usr/lib/x86_64-linux-gnu/libvolk.so.1.3.1 /usr/lib/x86_64-linux-gnu/libvolk.so.1.3 

It is a workaround due to an [issue](https://github.com/ptrkrysik/gr-gsm/pull/378#issuecomment-379587145) with faulty libvolk installation on these systems at the moment.

Then download the gr-gsm's source and build it with following commands:

git clone https://git.osmocom.org/gr-gsm
 cd gr-gsm
 mkdir build
 cd build
 cmake ..
 mkdir $HOME/.grc_gnuradio/ $HOME/.gnuradio/
 make
 sudo make install
 sudo ldconfig

To speedup compilation instead of "make" you can use parallel build

make -j $nproc

where "$nproc" is number of CPU cores
The "mkdir $HOME/.grc_gnuradio/ $HOME/.gnuradio/" line is there because without it parallel build sometimes fails.