Part of: 4G / 5G & O-RAN
Duranta is an open-source 5G base station and software UE. This page explains what it is, how its parts are laid out on COSMOS, which COSMOS hardware it uses, and which tutorial to take first.
A mobile network has three parts: the phone (the UE), the base station (in 5G, the gNB), and the core network, which checks the SIM, hands out an IP address and forwards traffic to the internet. Duranta provides the base station and a software phone, both running as ordinary programs on a Linux server. It is a fork of OpenAirInterface (OAI), a long-running open-source implementation of the 3GPP radio stack in C, and it is a project of LF Networking. It is permissively licensed and needs no licence server. Duranta releases are tagged by week; COSMOS runs tag 2026.w44 plus a small COSMOS patch set.
On COSMOS, Duranta runs with the OAI CN5G core. Two things set it apart. Its base station can manage a commercial O-RAN radio unit itself: it connects to the radio over the O-RAN management plane at start-up, configures it, and keeps that session open while the cell runs. And because its radio simulator can model a satellite channel, it can run a 5G satellite (NTN) link with no radio at all. Because Duranta keeps OAI's programs and configuration format, the OAI documentation applies to it.
A 5G base station is divided into functional units. 3GPP splits it into a central unit (CU), which holds the upper protocol layers and the links to the core, and a distributed unit (DU), which holds the real-time layers (scheduling and the upper physical layer). The O-RAN Alliance adds the radio unit (RU), which holds the lowest physical layer and the RF, and defines the fronthaul between DU and RU at split 7.2x, with a management plane (M-Plane) for configuring the RU. 5G SA fundamentals explains the layers and O-RAN and the 7.2x fronthaul explains the split and the M-Plane.
Duranta's nr-softmodem runs as a complete gNB (CU and DU together) in the tutorials without an O-RU, and as an O-DU in the O-RAN 7.2 tutorial. The radio is chosen by its configuration and command-line options.
| Part | What it does | Duranta component | Where it runs on COSMOS |
|---|---|---|---|
| CU and DU | radio protocols, scheduling, upper physical layer, links to the core | nr-softmodem |
a COSMOS server (/opt/duranta/cmake_targets/ran_build/build/) |
| Radio | lower physical layer and RF | no radio: RFsim, OAI's radio simulator, a TCP socket to the software UE · over the air: a USRP through UHD · O-RAN 7.2: fhi_72, a DPDK fronthaul to a separate O-RU |
no radio: the same server · over the air: a USRP N310 in sb1 · O-RAN 7.2: a commercial O-RU on the fronthaul network |
| O-RU management (M-Plane) | configures and supervises an O-RU over NETCONF | built into nr-softmodem (the M-Plane build of the fronthaul library); the DU holds the session for as long as the cell runs |
the O-DU server |
| Software O-RU | runs the O-RU side in software, with a USRP as its RF front end | nr-oru |
on the image; not used by the packaged tutorials |
| Core | authenticates the UE, assigns its IP address, forwards its traffic | OAI CN5G, Docker containers (oai-amf, oai-smf, oai-upf, mysql, oai-ext-dn) |
the same server as the gNB |
| UE | the phone | nr-uesoftmodem software UE (no-radio and satellite tutorials) · Quectel RM520N-GL modem |
nr-uesoftmodem on the gNB server; the modem on a separate UE node |
All Duranta tutorials use test PLMN 00101, DNN oai and UE pool 192.168.100.0/22 (gateway 192.168.100.1, with internet access).
duranta.ndz with omf load. It points at the newest promoted build; on 2026-11-02 that was duranta-w44-20261101 (Duranta 2026.w44). COSMOS keeps one image per weekly release (duranta-w37.ndz … duranta-w44.ndz), so a tutorial can be repeated on the release it was verified on. The image carries the OAI CN5G containers and the 7.2 host tooling used by the tutorials./opt/duranta, away from the path it was compiled in, so every launch must set LD_LIBRARY_PATH to the build directory; the tutorials show how.cosmos-tutorial check tests it). COSMOS servers come in three CPU platforms: 2× Intel Xeon Gold 6226 (24 cores, hyperthreading off), 2× Intel Xeon Gold 6126 (24 cores / 48 threads) and 1× AMD EPYC 9355P (32 cores). With no radio, the CPU is the only limit, so throughput differs strongly between them. One more server, an NVIDIA GH200 in rrail (Arm Grace CPU + Hopper GPU), runs Duranta's layer 2 with NVIDIA's GPU physical layer: see Duranta on NVIDIA Aerial.sb1, reached over the server's data network, with a Quectel modem on a UE node in the same domain.osc, sb1 and rrail, PTP time from the fronthaul switch, and a commercial O-RU from the O-RU pool: the Benetel RAN650 (driven over the M-Plane) or the LiteOn FlexFi (standalone). The O-DU needs isolated CPU cores, hugepages and an SR-IOV virtual function bound to DPDK; the image carries no CPU isolation because the right cores differ per server. See Preparing a real-time RAN host.| Tutorial | Radio? | Domains | Time | What you learn |
|---|---|---|---|---|
| duranta-soft | no | any | 20–30 min | what a working 5G network looks like: core, gNB and software UE on one server over RFsim; the attach milestones; measuring throughput |
| duranta-ota | yes: USRP N310 + Quectel modem | sb1 |
60–90 min | running a real cell over the air and attaching a commercial modem; real-time streaming to a radio |
| duranta-72 | yes: commercial O-RU + Quectel modem | osc, sb1, rrail |
90–150 min | the O-RAN 7.2 split; the DU configuring the O-RU over the M-Plane; host preparation for the fronthaul |
| duranta-ntn | no (simulated satellite) | any | 30–40 min | a 5G satellite link (GEO and LEO): how SIB19, timing advance and HARQ cope with a half-second round trip |
Step-by-step procedures that are not yet packaged as cosmos-tutorial runs (they are run by hand, and may be older):
Measured throughput for every Duranta build, by radio and CPU platform, is on Duranta performance by build.
Glossary
- gNB — the 5G base station. CU / DU — its central and distributed units (3GPP).
- RU / O-RU — the radio unit; "O-RU" when it follows the O-RAN specifications. O-DU — a DU that drives an O-RU.
- 7.2x split / fronthaul — the O-RAN split point inside the physical layer, and the Ethernet link between O-DU and O-RU.
- M-Plane — the O-RAN management plane: NETCONF over SSH, used to configure and supervise an O-RU.
- RFsim — OAI's radio simulator: radio samples over a TCP socket instead of through a radio.
- NTN — non-terrestrial network: a 5G link through a satellite. SIB19 — the broadcast message that tells the UE where the satellite is.
- DNN — the data network a UE asks for (
oaihere). PDU session — the UE's data connection, which gives it an IP address.
How every Duranta build performed, round by round, with one chart per radio, carrier and CPU platform (13 series, newest round 2026-11-02), is on Duranta performance trend by build. Every weekly rebake and test round adds to it.
fhi_72 O-DU, DPDK and PTP set-up.Author(s): COSMOS team · Tags: duranta, oai, 5g, sa, oran, ntn, overview