Prerequisites

xApp SDK Source Code

For this training, you will need BubbleRAN's xApp SDK, which is available in our Github repository. For running these labs, you will need a Linux system with network access to your BubbleRAN MX-PDK. Ideally, these labs should be performed on the control-plane node of your MX-PDK, e.g., via SSH.

Getting started

1. Install common dependencies in Ubuntu: (at least python3.8)

sudo apt install libsctp-dev python3 cmake-curses-gui python3-dev pkg-config libconfig-dev libconfig++-dev python3-pip

2. Install python packages

pip3 install tabulate

danger

Before running this xApp training you should make sure ALL your composition models are up-to-date.

Please refer to these steps to do so.

Amarisoft UE model

The Amarisoft and OCUDU blueprints use amarisoft/amr-ue or amarisoft/amr-ue-ntn. These deployment modes are available in the Amarisoft CompositionModel chart 2026.6.2-beta. The stable 2026.6.1 chart does not include them.

Install the required model before applying these blueprints:

brc install model amarisoft --set version=2026.6.2-beta

xApp SDK through Github

To obtain the BubbleRAN xApp SDK, clone the repository:

git clone https://github.com/bubbleran/xapp_sdk.git

The repository has the following structure:

.
├── CMakeLists.txt
├── conf
│ ├── README.md
│ ├── update_conf.py
│ ├── xapp_all_sm.yaml
│ ├── xapp_cust_sm.yaml
│ ├── xapp_oran_sm_amr.yaml
│ ├── xapp_oran_sm_oai.yaml
│ ├── xapp_oran_sm_ocudu.yaml
│ ├── xapp_oran_sm.yaml
│ └── xapp.yaml
├── CONTRIBUTING.md
├── include
│ └── src
├── labs
│ ├── CMakeLists.txt
│ ├── lab1.c
│ ├── lab2.py
│ ├── lab3.c
│ ├── lab5.c
│ ├── lab5.py
│ ├── lab6.c
│ └── README.md
├── lib
│ ├── libe42_xapp.a
│ ├── libe42_xapp_shared.so
│ ├── libe42_xapp_shared_vm.so
│ ├── libe42_xapp_vm.a
│ ├── libxapp_sdk_c.a
│ ├── libxapp_sdk_c_vm.a
│ ├── _xapp_sdk_python.so
│ ├── _xapp_sdk_python_vm.so
│ ├── _xapp_usr_sdk.so
│ └── _xapp_usr_sdk_vm.so
├── LICENSE
├── NOTICE
├── README.md
└── src
    ├── CMakeLists.txt
    ├── dev
    └── usr

Build and install

mkdir build

cd build

There are two options for the next command, depending on whether you need a database.

• No DB (default): cmake ..
• VictoriaMetrics (Recommended): cmake -DXAPP_DB=VICTORIAMETRICS_XAPP ..

After which, complete the build with the next commands:

make -j

sudo make install

sudo ldconfig