Versions this guide is based on:

EVE Image Name Folder Downloaded Filename Version vCPUs vRAM
xrv9k-fullk9-6.3.3 fullk9-R-XRV9000-633.tar fullk9-R-XRV9000-633 4 16384
xrv9k-fullk9-6.5.1 fullk9-R-XRV9000-651.tar fullk9-R-XRV9000-651 4 16384

Other versions should also be supported following bellow's procedure.


Using any suitable archive program, unzip original fullk9-R-XRV9000-633.tar to obtain ISO image: xrv9k-fullk9-x-6.3.3.iso

Steps below are based on xrv9k-R-XRV9000-633 creation, for other image deployment, use proper names respectively.

1. SSH to EVE and login as root, from cli and create temporary working directory on the EVE's root:

mkdir /opt/unetlab/addons/qemu/xrv9k-fullk9-6.3.3

2. Upload the  xrv9k-fullk9-x-6.3.3.iso image to the EVE /opt/unetlab/addons/qemu/xrv9k-fullk9-6.2.3/ using, for example, FileZilla or WinSCP.

3. From cli go to created directory:

cd /opt/unetlab/addons/qemu/xrv9k-fullk9-6.3.3/

4. Create new hdd disk for your your image:

/opt/qemu/bin/qemu-img create -f qcow2 virtioa.qcow2 45G

5. Start XRv9k installation (10-20 mins), one line CLI command:

NOTE: If you are installing other version of XRv9k please change ISO image name accordingly your ISO filename

/opt/qemu-2.2.0/bin/qemu-system-x86_64  -nographic -drive file=virtioa.qcow2,if=virtio,bus=0,unit=0,cache=none -machine type=pc-1.0,accel=kvm -serial mon:stdio -nographic -nodefconfig -nodefaults -rtc base=utc -cdrom xrv9k-fullk9-x-6.3.3.iso -boot order=dc  -m 16384

6. After installation is completed, XRv9k will prompt again, Now Stop XRv9k booting and get to qemu prompt using key combo ctrl+a and then press c, once appears (qemu) type quit.

(qemu) quit

7. Open new EVE lab, add recently installed node and start it. After first boot probably it will look crash crash, it depends of your server CPU model, but no worries, if you see this, simply stop node and start again. New generation CPUs like E5-26XX series must be fine with first boot. Older CPUs second boot should fix node boot nicely.

8. Wait till the node is fully booted, set username and password when prompt. Example: admin/admin

  Enter root-system username: admin
  Enter secret: admin
  Enter secret again:admin

9. Check if your new XRv9k shows interfaces (takes time 5-10mins), if so, your node installation is completed.


10. Right click on node to stop it


IMPORTANT: Commit the installation to set it as the default image for further use in EVE-NG:

11. On the left side-bar within the lab in the EVE Web-UI choose “Lab Details” to get your lab’s UUID details: In this example: UUID: b035d5e0-02d1-4e1a-aa3a-e3e3c8a97b64

12. Find out the POD ID of your used and the Node ID of your newly installed node.

The POD number is assigned to your username, and can be found in the EVE GUI, Management/User Management. The Admin user uses POD number 0 by default. In this example I have POD nr. 0

The Node ID can be obtained by right clicking the node on the topology. In this Example it is 8

13. From the EVE CLI, locate the installed image and commit your changes to be used as default for further use in EVE-NG:

cd /opt/unetlab/tmp/0/b035d5e0-02d1-4e1a-aa3a-e3e3c8a97b64/8/


/opt/qemu/bin/qemu-img commit virtioa.qcow2

14. Remove cdrom.iso from /opt/unetlab/addons/qemu/win-7test/

cd /opt/unetlab/addons/qemu/xrv9k-fullk9-6.3.3/

rm -f xrv9k-fullk9-x-6.3.3.iso

15. Fix permissions

/opt/unetlab/wrappers/unl_wrapper -a fixpermissions


XRv9000 Node is very heavy and suitable for servers EVEs only. Boot time takes time, patience, just wait till in show run appears GE interfaces. Node is ready.