UERANSIM

<p align="center"> <a href="https://github.com/aligungr/UERANSIM"><img src="/.github/logo.png" width="75" title="UERANSIM"></a> </p> <p align="center"> <img src="https://img.shields.io/badge/UERANSIM-v3.2.7-blue" /> <img src="https://img.shields.io/badge/3GPP-R15-orange" /> <img src="https://img.shields.io/badge/License-AGPL--3.0-green"/> </p>

UERANSIM <small>(pronounced "ju-i ræn sɪm")</small>, is the open source state-of-the-art 5G UE and RAN (gNodeB) simulator. UE and RAN can be considered as a 5G mobile phone and a base station in basic terms. The project can be used for testing 5G Core Network and studying 5G System.

UERANSIM introduces the world's first open source 5G-SA UE and gNodeB implementation.

[!IMPORTANT] UERANSIM is no longer actively developed by the maintainer. However community contributions are welcomed.

Current Status

Basic functionalities of UE and gNodeB are fully functional and ready to use. However some of the features are not complete. More details can be found at Feature Set.

On the other hand, UERANSIM does not fully provide physical layer. 5G-NR radio interface is partially implemented, and simply simulated over UDP protocol.

<p align="center"> <img src="https://img.shields.io/badge/Radio%20Interface-simulated-orange" alt="OS Linux"/> <img src="https://img.shields.io/badge/Control%20Plane-functional-green" alt="OS Linux"/> <img src="https://img.shields.io/badge/User%20Plane-functional-green" alt="OS Linux"/> </p>

Documentation

You can find the documentation on UERANSIM Wiki.

And, since the project is rapidly developing, please make sure that you have always the latest UERANSIM.

Contributing

Any contributions you make are greatly appreciated via Pull Request.

Supporting

You can support UERANSIM by:

• Starring the GitHub repository,
• Donating on Open Collective
• Creating pull requests, submitting bugs, suggesting new features or documentation updates.

License

Copyright (c) 2025 ALİ GÜNGÖR.

All source code and related files including documentation and wiki pages are dual licensed with AGPL-3.0 and a commercial license.

[!WARNING] Closed-source commercial usage of UERANSIM may not be permitted with the AGPL-3.0. If that license is not compatable with your use case, please contact ueransim@gmail.com to buy a commercial license.