Version R2 of the documentation is no longer actively maintained. The site that you are currently viewing is an archived snapshot. For up-to-date documentation, see the latest version.

Nephio demo on Windows

Step by step guide to run Nephio on Windows

Nephio demo on Windows


  • install git
  • install virtualbox
  • install vagrant
  • open git bash
  • git clone && cd test-infra/e2e/provision
  • vagrant up
  • vagrant ssh -- -L 7007:localhost:7007 -L 3000:


The Vagrant networking will not work on Windows to allow access to the Nephio Web UI and Gitea Web UI due the Hyper-V limitation. Meanwhile, for VirtualBox (used here), we can create an internal network by adding the following line to the Vagrant.configure: "private_network", ip: "", virtualbox__intnet: true

But the easiest way is to force the port-forwarding as shown before:

vagrant ssh -- -L 7007:localhost:7007 -L 3000:

Tests were done on:

  1. Laptop: Windows 11 i7-10750H (16 T) 32GB ram (8VCPU 32GB)

  2. Laptop: Windows 10 i5-7200U (4T) 24GB ram (4VCPU 16RAM)


Warning: For low-end machines (less then 8T32GB), you will need to modify the Vagrant file. This is not recommended!

  • In the Vagrant file “./Vagrantfile”, there are CPUS & RAM parameters in config.vm.provider, it’s possible to override them at runtime:

    • On Linux, or the Git Bash on Windows we can use a one-liner command CPUS=16 MEMORY=32768 vagrant up
  • In the Ansible “./playbooks/roles/bootstrap/tasks/prechecks.yml” file, there are the checks for CPUS & RAM