Installation Guide

Which Installation Should I Use?

srsRAN can be installed from packages or from source. The following decision tree should help users decide which is best for them:

../../_images/download_decision.png

In short, users looking for a simple installation who only expect to run basic srsRAN applications with USRP front-ends should use the package installation. Users who wish to modify srsRAN and/or use alternative RF front-ends such as limeSDR and BladeRF should install from source.

Package Installation

The srsRAN software suite can be installed using packages on Ubuntu:

sudo add-apt-repository ppa:srsran/releases
sudo apt-get update
sudo apt-get install srsran -y

Package installs are also available for other distributions.

Note, only the Launchpad packages for Ubuntu are maintained by SRS. Different distributions will maintain their own packages for srsRAN, which may or may not be up to date. Check the available version before installing to ensure you are using the desired version of srsRAN.

Fedora does not yet have support for a package installation of srsRAN.

Installation from Source

For example, on Ubuntu, one can install the required libraries with:

sudo apt-get install build-essential cmake libfftw3-dev libmbedtls-dev libboost-program-options-dev libconfig++-dev libsctp-dev

or on Fedora:

dnf install cmake fftw3-devel mbedtls-devel lksctp-tools-devel libconfig-devel boost-devel

For CentOS, use the Fedora packages but replace libconfig-devel with just libconfig.

Note that depending on your flavor and version of Linux, the actual package names may be different.

Note

If using UHD we recommended the LTS version of UHD, i.e. either 3.9.7 or 3.15.

Download and build srsRAN:

git clone https://github.com/srsRAN/srsRAN.git
cd srsRAN
mkdir build
cd build
cmake ../
make
make test

Install srsRAN:

sudo make install
sudo srsran_install_configs.sh user

This installs srsRAN and also copies the default srsRAN config files to the user’s home directory (~/.srs).