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 ..

1. The parallel build sometimes fails when the .grc_gnuradio
2. and .gnuradio directories do not exist
   mkdir $HOME/.grc_gnuradio/ $HOME/.gnuradio/
   make #to speedup compilation you can use parallel build
   #"make -j $nproc" where $nproc is number of CPU cores
   sudo make install
   sudo ldconfig
   ```