{"id":25322665,"url":"https://github.com/lenss/5g-core-network","last_synced_at":"2025-06-26T08:35:45.907Z","repository":{"id":183857397,"uuid":"644958133","full_name":"LENSS/5G-Core-Network","owner":"LENSS","description":null,"archived":false,"fork":false,"pushed_at":"2023-09-09T18:56:42.000Z","size":14,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-07T22:41:44.115Z","etag":null,"topics":["5g","5g-core-network"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LENSS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2023-05-24T15:53:50.000Z","updated_at":"2024-10-26T02:11:42.000Z","dependencies_parsed_at":"2025-04-07T22:41:36.628Z","dependency_job_id":"a40f7563-5b49-4ec7-b5ae-eacb9f9fc128","html_url":"https://github.com/LENSS/5G-Core-Network","commit_stats":null,"previous_names":["lenss/5g-core-network"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/LENSS/5G-Core-Network","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LENSS%2F5G-Core-Network","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LENSS%2F5G-Core-Network/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LENSS%2F5G-Core-Network/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LENSS%2F5G-Core-Network/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LENSS","download_url":"https://codeload.github.com/LENSS/5G-Core-Network/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LENSS%2F5G-Core-Network/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262030747,"owners_count":23247708,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","5g-core-network"],"created_at":"2025-02-13T23:47:22.056Z","updated_at":"2025-06-26T08:35:45.897Z","avatar_url":"https://github.com/LENSS.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# LENSS 5G-Core-Network\n\n## What is the LENSS 5G-Core-Network?\nThis project presents the first widely available open-source 5G core network to combine the capabilities of [Open5GS](https://open5gs.org) and [Free5GC](https://free5gc.org). \n\n### Why combine both cores?\nOpen5GS allows the usage of both 4G-LTE and 5G-NSA network stacks, while Free5GC allows the usage of 5G-SA with non-3GPP access network based sessions (ie. MA-PDU sessions over multiple access networks concurrently). Our goal is to provide a solution that allows researchers complete flexibility when developing solutions for current and upcoming 3GPP deployments.\n\n## Installation\n1. Clone the repository at `https://github.com/LENSS/5G-Core-Network` being sure to clone recursively in order to clone both sub-projects for each core network.\n``` \ngit clone --recurse-submodules https://github.com/LENSS/5G-Core-Network.git\n```\n2.  Initialize the repository (ie. build and setup)\n```\nmake validate\nmake init-mongodb\nmake init\n```\n* `make validate` ensures you have the correct versions of the various requirements of both core networks.\n* `make init-mongodb` installs and starts the MongoDB daemon on your system.\n* `make init` clones and builds both core networks and installs the correct configurations files we have prepared.\n\nNote: You will need to update the configurations files for Open5GS and the Free5GC N3IWF with the IP addresses of your network interfaces.\n\n## Running\nRun `make start` to run both core networks, using our custom script `run-bg-process.sh` to use have them run in the background while storing their individual log files.\n\nNote: update `/script/run-open5gs.sh` with the correct IP addresses of your network interfaces prior to starting the core network. The section that is important to update is for the creation of virtual IP addresses for your main network interface (ie. can reach the internet):\n``` \nsudo ip addr add 192.168.2.170/24 br 192.168.2.255 dev ens160 || true # for UPF\nsudo ip addr add 192.168.2.179/24 br 192.168.2.255 dev ens160 || true # for UPF\nsudo ip addr add 192.168.2.171/24 br 192.168.2.255 dev ens160 || true # for UE\nsudo ip add show dev ens160 || true\n```\n\n## Stopping the Core\nRun `make stop` to terminate the core network.\n\n## Network Function Logs\nUse the `/script/run-bg-process.sh` to tail the logs of each network function. For example, to see all running processes, run:\n``` \nrun-bg-process.sh \n```\nTo see the logs of a given running process by name, run:\n``` \nrun-bg-process.sh -l -n [PROCESS_NAME]\n```\n\n## Adding Devices\nBefore using the core network, you will need to add registered devices. See the instructions [here](https://open5gs.org/open5gs/docs/guide/02-building-open5gs-from-sources/) for using the Open5GS web UI to easily add users, or access the MongoDB instance directly (not recommended).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flenss%2F5g-core-network","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flenss%2F5g-core-network","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flenss%2F5g-core-network/lists"}