OpenAirInterface Workshops and Hackathons

Hello everyone, and welcome to the OpenAirInterface Workshops and Hackathons homepage. Here, you will find information and resources to get started with our hands-on workshops and hackathons.

As a prerequisite, please clone the workshop repository:

git clone https://github.com/openairinterface/workshop.git

Please refer to the README of the relevant workshop or hackathon for any additional prerequisites, including software dependencies, hardware requirements, and environment setup instructions.

OpenAirInterface Hackathon 2026 North Carolina State University

Please refer to the Hackathon README for further information.

OpenAirInterface Hands-On Workshop

Hardware Requirements

1. A laptop or remote server with minimum 4vCPU and 8GB of RAM and 4GB of storage.
2. Make sure your laptop/remote server CPU supports avx2 as it is needed by gNB/NR-UE containers. You can check via lscpu | grep avx2
3. Operating System: Ubuntu 22.04/24.04, RHEL 9/10, Fedora 40+, other linux based OS may work as well.
4. Note: Apple M1/M2/M3 laptops and Windows Linux Subsystem (WSL) are not yet tested.

Software Prerequisites

Software	Version
Docker engine	Minimum 25.04
tshark	Minimum 4.6.0
wireshark	Minimum 4.6.0

Recommendation: You can download terminal application terminator or similar application to open multiple terminals in the same screen.

In case you do not have docker and wireshark you can download,

:red-exclamation-mark: Make sure to select yes when the Wireshark installation asks you whether non-superusers should be able to capture packets. Otherwise, you will have to run in sudo mode.

sudo add-apt-repository ppa:wireshark-dev/stable
sudo apt update
sudo apt install -y git net-tools wireshark

sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu  $(lsb_release -cs)  stable"
sudo apt update
sudo apt install -y docker docker-ce

Add your username to the docker group, otherwise you will have to run in sudo mode.

sudo usermod -a -G docker $(whoami)

Now, logout and login again.

To follow the hands-on tutorials:

1. Core Network Hands-on Tutorial
2. RAN Hands-on Tutorial
3. OAM Hands-on Tutorial