{"id":36784323,"url":"https://github.com/nextmn/testbed","last_synced_at":"2026-01-12T13:19:38.175Z","repository":{"id":219262820,"uuid":"741990251","full_name":"nextmn/testbed","owner":"nextmn","description":"NextMN testbed","archived":false,"fork":false,"pushed_at":"2025-11-21T01:28:29.000Z","size":395,"stargazers_count":0,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-11-21T03:28:08.927Z","etag":null,"topics":["5g","free5gc","mobile-networks","nextmn","testbed","ueransim"],"latest_commit_sha":null,"homepage":"","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nextmn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-01-11T14:33:19.000Z","updated_at":"2025-11-21T01:28:31.000Z","dependencies_parsed_at":"2024-04-09T11:38:41.915Z","dependency_job_id":"e50dece8-0541-48e8-931f-b49ae6324bb2","html_url":"https://github.com/nextmn/testbed","commit_stats":null,"previous_names":["nextmn/testbed"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/nextmn/testbed","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextmn%2Ftestbed","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextmn%2Ftestbed/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextmn%2Ftestbed/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextmn%2Ftestbed/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nextmn","download_url":"https://codeload.github.com/nextmn/testbed/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextmn%2Ftestbed/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28338996,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T12:22:26.515Z","status":"ssl_error","status_checked_at":"2026-01-12T12:22:10.856Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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","free5gc","mobile-networks","nextmn","testbed","ueransim"],"created_at":"2026-01-12T13:19:38.058Z","updated_at":"2026-01-12T13:19:38.136Z","avatar_url":"https://github.com/nextmn.png","language":"Jinja","readme":"# Testbed\n![CI](https://github.com/nextmn/testbed/actions/workflows/main.yml/badge.svg)\n\n## Getting started\n### Dependencies\nThis testbed has been developped using Debian 12 (Bookworm), but it should also work on all other Linux distributions supported by Docker as long as a Linux kernel is used on the host system (incompatible with Microsoft WSL).\n\nThe following Debian's packages are required (or their equivalent on your distribution):\n- [`docker-ce`](https://docs.docker.com/engine/install/debian/#install-using-the-repository)\n- [`docker-compose-plugin`](https://docs.docker.com/compose/install/linux/#install-using-the-repository)\n- `python3`\n- `python3-yaml`\n- `j2cli`\n- `make`\n- `acl`\n- `openssl`\n- `python3-matplotlib`\n\n\u003e[!NOTE]\n\u003e If you intend to use Free5GC’s UPF (with `make set/dataplane/free5gc`),\n\u003e install [Free5CG's GTP5G kernel module](https://github.com/free5gc/gtp5g) on your host.\n\u003e Please note that you need to have Linux headers installed on the host to be able to install the module\n\u003e (for example, the package `linux-headers-amd64` on Debian if you are on an amd64 architecture).\n\n### Usage\n\u003e [!IMPORTANT]\n\u003e Make sure to enable IPv6.\nThis can be done by adding the following in `/etc/docker/daemon.json`:\n ```json\n{\n\t\"ipv6\": true,\n\t\"fixed-cidr-v6\": \"fdd4:95c2:f557::/64\"\n}\n```\n\n```text\nmake build # build\nmake pull # update docker images\nmake up # run containers\nmake down # stop containers\n```\n\nThe Makefile provides some other commands you might want to use. They are described in [`doc/Commands.md`](https://github.com/nextmn/testbed/wiki/Commands)\n\n#### Configuration\nConfiguration is done in the file [`default-config.yaml`](./default-config.yaml). Currently, it only contains a list of IP addresses.\n\n#### Documentation\nDocumentation is available in the [`doc`](./doc) directory.\n\n![edge intance access through SRv6](./img/edge-instance-access-through-srv6.svg)\n\n### Contributing\n#### Syntax coloration\nTo enable syntax coloration in Vim, you can use the following plugin: [`nextmn/vim-yaml-jinja`](https://github.com/nextmn/vim-yaml-jinja).\n\n#### PCAP analysis\nTo analyse RAN traffic, you can install the following Wireshark/Tshark plugin : [`nextmn/RLS-wireshark-dissector`](https://github.com/nextmn/RLS-wireshark-dissector).\n\n### Known issues\n- Docker version `5:25.0.0` has [a bug](https://github.com/moby/moby/issues/47120) that prevent running the testbed. Use a different version (`5:25.0.1` or higher, or `5:24.*` or lower).\n- To be able to use Free5GC's UPFs along with NextMN-Lite (`make set/dataplane/free5gc \u0026\u0026 make set/controlplane/nextmn-lite`), you must use [`free5gc/gtp5g`](https://github.com/free5gc/gtp5g) v0.9.6 or higher.\n- To be able to use Free5GC's UPF along with the latest version of `louisroyer/dev-free5gc-smf`, you must use a version of `free5gc/gtp5g` v0.9.13 or higher.\n\n## Copyright\n### Author\nLouis Royer\n\n### License\nThe testbed code in this repository is under the MIT license, but the various software used, which are distributed in particular in the form of Docker images, are under other licenses.\nNotably:\n- [UERANSIM](https://github.com/aligungr/UERANSIM) is under the GPL-3.0 license\n- [Free5GC](https://github.com/free5gc) is under the Apache-2.0 license\n- Debian packaged softwares are under various free licenses available at `/usr/share/doc/*/copyright` into Docker images.\n","funding_links":[],"categories":["Lab \u0026 Testbeds"],"sub_categories":["Ready-to-Use Environments"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextmn%2Ftestbed","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnextmn%2Ftestbed","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextmn%2Ftestbed/lists"}