Native Installation

Note

RAN Tester UE requires Ubuntu and is officially tested on Ubuntu 24.04 LTS.

1. Install Build Dependencies

The srsRAN UE system has the following necessary dependencies:

UHD

ZMQ

boost

cmake

gcc

make

sudo apt-get update && sudo apt-get install -y cmake gcc g++ make libzmq3-dev libboost-all-dev \
    libuhd-dev uhd-host pkg-config libfftw3-dev libmbedtls-dev libsctp-dev libyaml-cpp-dev libgtest-dev

2. Clone Repository

Clone the RAN Tester UE repository with submodules:

git clone --recurse-submodules https://github.com/oran-testing/ran-tester-ue

3. Build from Source

Compile and install the software:

cd ran-tester-ue
mkdir build && cd build
cmake ../
make -j $(nproc)
sudo make install

Testing against a RAN

Refer to srsRAN’s documentation for setting up a gNB with ZMQ or UHD. Use our pre-tested configs:

ZMQ files: ran-tester-ue/configs/zmq
UHD files: ran-tester-ue/configs/uhd/multi_ue

Note

Use the subscriber_db.csv in ran-tester-ue/configs for Open5GS. We recommend the Docker Compose version. Copy it to docker/open5gs and modify open5gs.env.