{"id":15068128,"url":"https://github.com/oran-testing/ran-tester-ue","last_synced_at":"2026-01-25T18:31:24.656Z","repository":{"id":247438358,"uuid":"825829082","full_name":"oran-testing/ran-tester-ue","owner":"oran-testing","description":"Open source RAN UE centric security testing software.","archived":false,"fork":false,"pushed_at":"2025-10-29T21:40:14.000Z","size":305626,"stargazers_count":14,"open_issues_count":9,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-29T23:14:49.934Z","etag":null,"topics":["5g-nr","c","cplusplus","cybersecurity","python3","srsran","wireless"],"latest_commit_sha":null,"homepage":"https://linktr.ee/rantesterue","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oran-testing.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-07-08T15:22:50.000Z","updated_at":"2025-10-29T21:40:18.000Z","dependencies_parsed_at":"2025-08-28T01:04:39.262Z","dependency_job_id":"c3f87db5-8716-482e-8091-f299e1531b77","html_url":"https://github.com/oran-testing/ran-tester-ue","commit_stats":{"total_commits":257,"total_committers":10,"mean_commits":25.7,"dds":"0.19455252918287935","last_synced_commit":"ad35fefff77b8da5471e19bf602e91b84d4e880c"},"previous_names":["oran-testing/soft-t-ue","oran-testing/ran-tester-ue"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/oran-testing/ran-tester-ue","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oran-testing%2Fran-tester-ue","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oran-testing%2Fran-tester-ue/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oran-testing%2Fran-tester-ue/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oran-testing%2Fran-tester-ue/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oran-testing","download_url":"https://codeload.github.com/oran-testing/ran-tester-ue/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oran-testing%2Fran-tester-ue/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28756442,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T16:32:25.380Z","status":"ssl_error","status_checked_at":"2026-01-25T16:32:09.189Z","response_time":113,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["5g-nr","c","cplusplus","cybersecurity","python3","srsran","wireless"],"created_at":"2024-09-25T01:31:01.311Z","updated_at":"2026-01-25T18:31:24.651Z","avatar_url":"https://github.com/oran-testing.png","language":"Python","funding_links":[],"categories":["Radio Access Network"],"sub_categories":["5G"],"readme":"# NTIA RAN Tester UE\n\nThis project is a security testing tool based on modifications and attacks from the User Equipment, designed to test 5G and open radio access networks (RANs) via the Uu air interface between the UE and the network. While enabling various types of testing, the primary focus of this software is on RAN security testing.  \n\n---\n\nThis RAN tester UE (rtUE) is fully software-based and compatible with widely available, commercial off-the-shelf (COTS) software radio hardware. Standardized 3GPP or O-RAN tests, as well as custom test procedures, can be implemented and executed at minimal cost and at different stages of RAN development and integration. This system facilitates testing across multiple commercial and open-source RAN implementations with minimal technical overhead. Additionally, many attacks on the RAN can be executed automatically by the system.\n\n---\n\nSee the our comprehensive [documentation ](https://docs.rantesterue.org) for more info on our attacks and metrics.\n\n## Quickstart Guide\n\n***First, clone the core repository and it's submodules.***\n\nOption A: SSH URL (Recommended if you have SSH set up)\n\n```bash\ngit clone --recurse-submodules git@github.com:oran-testing/ran-tester-ue.git\n```\n\nOption B: HTTPS\n\n```bash\ngit clone --recurse-submodules https://github.com/oran-testing/ran-tester-ue.git\n```\n\n***Navigate to the directory and run the system setup script:***\n```bash\ncd ran-tester-ue\nsudo ./scripts/system_setup.sh\n```\n\n***Now, pull the necessary containers from our registry:***\n\n```bash\nsudo docker compose --profile components pull  # Pulls all attack components\nsudo docker compose --profile system pull      # Pulls Grafana, InfluxDB, and Controller\n```\n\nAlternatively, you can build the images yourself:\n\n```bash\nsudo docker compose --profile components build  # Builds all attack components\nsudo docker compose --profile system build      # Builds Grafana, InfluxDB, and Controller\n```\n\nThe environment is defined in the controller config (`ran-tester-ue/configs`):\n\nThis configuration tells the controller which services to run, and in what order. This allows for fully automated tests with many components.\n```yaml\nprocesses:                                                # List of all processes to start\n- type: \"rtue\"\n    id: \"rtue_uhd_1\"\n    config_file: \"configs/uhd/ue_uhd.conf\"                # Path to the configuration file for the rtUE\n    rf:\n        type: \"b200\"                                      # Type of RF device (= USRP B210)\n        images_dir: \"/usr/share/uhd/images/\"              # Directory for RF images\n\n- type: \"sniffer\"\n    id: \"dci_sniffer_1\"\n    config_file: \"../5g-sniffer/MSU-Private5G184205.toml\" # Path to the configuration file for the sniffer\n    rf:\n        type: \"b200\"\n        images_dir: \"/usr/share/uhd/images/\"\n```\n\nThe config used by the controller is defined in `ran-tester-ue/.env` as ```DOCKER_CONTROLLER_INIT_CONFIG```. Change this value to use a different configuration.\n\n\nThe following will run a sniffer and UE with the requested environment, writing all data to influxdb and displaying metrics in realtime with grafana:\n\n```bash\nsudo docker compose --profile system up\n```\n\nThe Grafana dashboard can be accessed at [http://localhost:3300](http://localhost:3300).\n\n\n## Nvidia Setup\nRun the following command to setup docker to use the nvidia gpu\n```bash\nsudo ./scripts/nvidia_toolkit_setup.sh\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foran-testing%2Fran-tester-ue","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foran-testing%2Fran-tester-ue","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foran-testing%2Fran-tester-ue/lists"}