Open source UE

Install srsRAN UE

Build and install srsRAN Project / srsRAN 4G on Ubuntu and Debian, including dependencies, UHD and LimeSuite drivers, and a working srsUE binary.

8 min read

srsRAN is the most widely used open-source cellular stack, and srsUE is the easiest legitimate UE to certify against a real TTCN-3 suite. This page gets you a working srsUE on Ubuntu 22.04 or 24.04.

You do not need SDR hardware to follow along. If you plan to run against an AEON lane, the radio is remote — install the drivers anyway so the same binary works on your bench.

Dependencies

bashbash
sudo apt update
sudo apt install -y \
  build-essential cmake git pkg-config \
  libfftw3-dev libmbedtls-dev libboost-program-options-dev \
  libconfig++-dev libsctp-dev libzmq3-dev \
  libuhd-dev uhd-host limesuite limesuite-udev

Fetch UHD firmware (Ettus B210)

bashbash
sudo uhd_images_downloader
uhd_find_devices

Build srsRAN 4G (contains srsUE)

bashbash
git clone https://github.com/srsRAN/srsRAN_4G.git
cd srsRAN_4G
mkdir build && cd build
cmake ../ -DCMAKE_BUILD_TYPE=Release
make -j"$(nproc)"
sudo make install
sudo srsran_install_configs.sh user

srsue --help | head -20

notesrsRAN 4G ships srsUE (LTE + NSA). For 5G SA gNB work use srsRAN Project; the UE side for SA conformance is typically srsUE with the 5G NR PHY enabled or a vendor stack.

Verify the build

bashbash
srsue --version
ldd "$(which srsue)" | grep -E 'uhd|Lime' || echo "no radio driver linked (ZMQ-only build)"

Common install failures

SymptomCause / fix
Could NOT find MBEDTLSInstall libmbedtls-dev; on older distros build mbedTLS 2.x from source.
No UHD device foundRun sudo uhd_images_downloader, then re-plug the B210 on a USB 3.0 port.
LimeSDR not detectedInstall limesuite-udev and reload rules: sudo udevadm control --reload-rules.
make hits OOMReduce parallelism: make -j2.

Run this against a real SDR lane

The tester is a service, not a box. Push a build, reserve a lane, get a verdict.