Skip to content
Switch branches/tags

UERANSIM (pronounced "ju-i ræn sɪm"), is the open-source state-of-the-art 5G UE and RAN (gNodeB) implementation. It 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 and only open source 5G-SA UE and gNodeB implementation. Some parts of this software are patent pending.

Current Status

Our UE and gNodeB are functional and ready to use. You can connect them to your 5G core network right now and start using it.

In terms of 3GPP coverage, fundamental control plane features are done. However, some of them are in progress. More details can be found at Feature Set.

At the same time, 5G-NR radio interface is under development but not complete yet. Currently we utilize the radio interface over a simulated environment.

OS Linux OS Linux OS Linux


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.


Any contributions you make are greatly appreciated via Pull Request.


You can support UERANSIM by:

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


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

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

Commercial usage of UERANSIM is not permitted with the GPL-3.0. If you want to use UERANSIM for commercial purposes, please contact to buy a commercial license.