Cisco SD-WAN EVE-NG Lab Installation

There are a number of options to build your own Cisco SD-WAN lab. I believe EVE-NG is your best option at the moment. In this lesson, I’ll show you everything you need to do to install EVE-NG and build your own Cisco SD-WAN lab. This includes:

  • Downloading the required Cisco and EVE-NG images.
  • Installing EVE-NG.
  • Installing the images on your EVE-NG installation.
  • Testing whether you can use the images.


You can run EVE-NG on physical hardware, or on a KVM or VMWare hypervisor. Details are on the EVE-NG requirements page. I’m going to install it on VMWare ESXi 7.


To get started, we need to download the Cisco SD-WAN and EVE-NG images.


To download the Cisco SD-WAN images, you need a CCO account with a contract. You can find the images at Cisco’s Software Download.


Cisco Sd Wan Software Download

You can run Cisco SD-WAN on multiple platforms, including VMWare ESXi, KVM, or Microsoft Azure. We need the KVM images for EVE-NG.


You can download EVE-NG from the download page. There are two options:

  • Professional/Learning Center Version
  • Community Edition Version

I downloaded the ISO of the professional version because of two reasons:

  • It’s the latest version.
  • It allows you to add/remove links without shutting down virtual devices.

The professional version requires a license but it’s definitely worth the money. Copy the ISO image to the datastore of your VMware ESXi server.


Let’s create a virtual machine for EVE-NG.

Port Groups

Before we create the virtual machine, we need to create some additional port groups. Take a look at the following picture:

Eve Ng Vmware Esxi Virtual Nics

I’m creating four port groups. The first port group (LAB) connects to the eth0 interface of the EVE-NG virtual machine. We use this so we can access the EVE-NG GUI or access it with SSH.

The other three port groups connect to different “cloud” networks that we can use within EVE-NG. We can use these to bridge virtual devices to our physical network. Each of the port groups uses a different VLAN. These cloud icons are useful for SD-WAN because we are going to use them to simulate different WAN connections.

Let’s create the port groups. Go to Networking in the Navigator:

Vmware Esxi Networking

Click on Add port group and create them:

Vmware Esxi Add Port Group

Make sure you change the security options to Accept on all port groups:

  • Promiscuous mode
  • MAC address changes
  • Forged transmits

We need this because the EVE-NG virtual machine creates different MAC addresses for the virtual devices. It’s also nice that we can use Wireshark if we ever want to look at our traffic.

Here’s what the end result looks like:

Vmware Esxi Port Groups Lab

Virtual Machine

Now we can create the virtual machine. Go to Virtual Machines in the Navigator:

Vmware Esxi Virtual Machines

Click Create / Register VM and select Create a new virtual machine:

Vmware Esxi Create New Vm Creation Type

Now we need to configure some parameters:

Vmware Esxi Create New Vm Name Eve

Set the Guest OS family to Linux and the Guest OS version to Ubuntu Linux (64-bit).  Choose a data storage:

Vmware Esxi Create New Vm Storage

Now we have to customize our virtual machine hardware. Don’t be shy with resources, you’ll need them. You need at least 19 GB of RAM and 6 vCPUs to run the Cisco SD-WAN controllers. You need more than that because we need to run vEdge routers and some “regular” IOS devices.

The vManage controller requires a 100 GB hard disk so make sure your EVE-NG virtual machine has plenty of storage. You can set the hard disk as “thin provisioned” because it probably won’t really use 100 GB of storage. Don’t forget to add network cards that map to your port groups. Also, map the CD/DVD drive to the EVE-NG ISO image you uploaded to the datastore:

Vmware Esx Customize Settings

Click on Next and Finish, then power on the virtual machine.

EVE-NG installation

All right, it’s time to install EVE-NG. The next few steps are probably familiar to you’ve if you installed Ubuntu before. Most of the steps are self-explanatory but let’s go through them anyway. Let’s select a language:

Eve Ng Installation Select Language

And select your location:

Eve Ng Installation Select Location

Now we need to select our network interface. This is what we’ll use to connect SSH into EVE-NG or access the GUI. Make sure you select the eth0 interface:

Eve Ng Installation Select Nic

We have to set a hostname:

Eve Ng Installation Configure Hostname

Set the time zone:

Eve Ng Installation Configure Timezone

Hit Enter if you don’t use a proxy:

Eve Ng Installation Configure Package Manager

Optionally, you can install security updates automatically. If you plan to use this virtual machine for a long time then it might be a good idea to do so:

Eve Ng Installation Updates

The installation will take a few minutes to complete.


Once the installation is complete, the virtual machine reboots and you see the following screen:

Eve Ng Login Screen

Log in and you are greeted with a setup screen. You need to set the hostname again:

Eve Ng Setup Hostname

And (optionally) a DNS domain name:

Eve Ng Setup Dns Domain

We can use DHCP or a static IP address. I’ll use a static IP address:

Eve Ng Setup Ip Address Static

Enter the IP address you want to use:

Eve Ng Setup Ip Address

With the subnet mask:

Eve Ng Setup Subnet Mask

And a default gateway:

Eve Ng Setup Default Gateway

Enter the primary DNS server:

Eve Ng Setup Primary Dns Server

And the secondary DNS server:

Eve Ng Setup Secondary Dns Server

If you have an NTP server, enter the address here:

Eve Ng Setup Ntp Server

If you have a proxy server, configure it here:

Eve Ng Setup Direct Connection Proxy

Once the setup completes, you’ll see the IP address on the CLI:

Eve Ng Login After Setup

You can now access EVE-NG through the GUI or with SSH.

Add Images

With EVE-NG up and running, we can add the Cisco SD-WAN images.

Open a web browser and type in the IP address of your EVE-NG virtual machine. You’ll see this screen:

Eve Ng Login Screen Gui

If you use the HTML5 console, you can access the CLI of your virtual devices through the web browser. I prefer the Native Console because it allows you to use your own applications like Putty or SecureCRT.

Once you are logged in, click on the Add new lab button:

Eve Ng Gui Add New Lab

Give your lab a name nd click on Save:

Eve Ng Gui Add New Lab Name

In the left menu, choose Add an object:

Eve Ng Add An Object

And select Node:

Eve Ng Node

In the dropdown, you only have two options at the moment:

Eve Ng Add New Node Empty

When we add new images, they will automatically show up here. This is how you can check whether EVE-NG detected your installed images.

Cisco SD-WAN Images

EVE-NG has an excellent tutorial that explains how to add the Cisco SD-WAN images. I’m using these three images:

  • viptela-vmanage-19.3.0-genericx86-64.qcow2
  • viptela-smart-19.3.0-genericx86-64.qcow2
  • viptela-edge-19.3.0-genericx86-64.qcow2

We need to copy these files and add them to the following folder:


Let’s create these folders.

# mkdir /opt/unetlab/addons/qemu/vtbond-19.3.0
# mkdir /opt/unetlab/addons/qemu/vtedge-19.3.0
# mkdir /opt/unetlab/addons/qemu/vtsmart-19.3.0
# mkdir /opt/unetlab/addons/qemu/vtmgmt-19.3.0

The name before the dash (-) has to match. You can add the version number behind the dash.

Use an application like SecureCRT, WinSCP, or Filezilla to copy the image files to the above folders. The vEdge image is also used for the vBond controller. Your folders and files should look like this now:

# ls -lR /opt/unetlab/addons/qemu
total 16
drwxr-xr-x 2 root root 4096 Jul 15 16:47 vtbond-19.3.0
drwxr-xr-x 2 root root 4096 Jul 15 16:46 vtedge-19.3.0
drwxr-xr-x 2 root root 4096 Jul 15 16:47 vtmgmt-19.3.0
drwxr-xr-x 2 root root 4096 Jul 15 16:47 vtsmart-19.3.0

total 241284
-rw-r--r-- 1 root root 247070720 Feb 20  2020 viptela-edge-19.3.0-genericx86-64.qcow2

total 241284
-rw-r--r-- 1 root root 247070720 Feb 20  2020 viptela-edge-19.3.0-genericx86-64.qcow2

total 1084676
-rw-r--r-- 1 root root 1110704128 Feb 20  2020 viptela-vmanage-19.3.0-genericx86-64.qcow2

total 241280
-rw-r--r-- 1 root root 247070720 Feb 20  2020 viptela-smart-19.3.0-genericx86-64.qcow2

We have to rename the image file names to virtioa.qcow2. Let’s use the mv command for this. Here’s the vBond image:

# cd /opt/unetlab/addons/qemu/vtbond-19.3.0/
# mv viptela-edge-19.3.0-genericx86-64.qcow2 virtioa.qcow2

The vEdge image:

# cd /opt/unetlab/addons/qemu/vtedge-19.3.0/
# mv viptela-edge-19.3.0-genericx86-64.qcow2 virtioa.qcow2

vSmart image:

# cd /opt/unetlab/addons/qemu/vtsmart-19.3.0/
# mv viptela-smart-19.3.0-genericx86-64.qcow2 virtioa.qcow2

And the vManage image:

# cd /opt/unetlab/addons/qemu/vtmgmt-19.3.0/
# mv viptela-vmanage-19.3.0-genericx86-64.qcow2 virtioa.qcow2

For the vManage image we have to do one more thing. This image requires a 100 GB hard disk. You can create it with the following command:

# /opt/qemu/bin/qemu-img create -f qcow2 virtiob.qcow2 100G
Formatting 'virtiob.qcow2', fmt=qcow2 size=107374182400 encryption=off cluster_size=65536 lazy_refcounts=off refcount_bits=16

And we need to set some permissions:

# cd
# /opt/unetlab/wrappers/unl_wrapper -a fixpermissions

Let’s take another look at our folders so we can see the end result:

# ls -lR /opt/unetlab/addons/qemu
total 16
drwxr-xr-x 2 root root 4096 Jul 15 16:49 vtbond-19.3.0
drwxr-xr-x 2 root root 4096 Jul 15 16:50 vtedge-19.3.0
drwxr-xr-x 2 root root 4096 Jul 15 16:52 vtmgmt-19.3.0
drwxr-xr-x 2 root root 4096 Jul 15 16:50 vtsmart-19.3.0

total 241284
-rw-r--r-- 1 root root 247070720 Feb 20  2020 virtioa.qcow2

total 241284
-rw-r--r-- 1 root root 247070720 Feb 20  2020 virtioa.qcow2

total 1084872
-rw-r--r-- 1 root root 1110704128 Feb 20  2020 virtioa.qcow2
-rw-r--r-- 1 root root     198656 Jul 15 16:52 virtiob.qcow2

total 241280
-rw-r--r-- 1 root root 247070720 Feb 20  2020 virtioa.qcow2

In the output above, you can see the 100 GB hard disk (virtiob.qcow2) that we created. It’s only using 198656 bytes at the moment.

That’s all we have to do on the CLI. When you go back to the GUI and try to add a new node, you should see more options:

Eve Ng Add New Node Cisco Sd Wan Images

You can now add one of the Cisco SD-WAN nodes. For example:

Eve Ng Add New Node Cisco Sd Wan Vbond

The default settings should be OK. Click on Save and add the node to your topology.

IOS Images

Before we wrap up this lesson, we should add some more images. It can be useful to have Cisco IOS routers and switches if you want to build a large topology.

I grabbed the following two vIOS images from my Cisco CML installation:

  • vios_l2-adventerprisek9-m.ssa.high_iron_20190423.qcow2 virtioa.qcow2

The first image is for a switch, the second one is a router. These images come with the  “refplat” ISO that you can download if you purchase Cisco CML. I have therefplat_p-20201110-fcs.iso image.

Like the Cisco SD-WAN images, we have to add some folders in the /opt/unetlab/addons/qemu folder. Let’s create those:

# mkdir /opt/unetlab/addons/qemu/vios-159-3
# mkdir /opt/unetlab/addons/qemu/viosl2-2019

Now I can copy the files with SCP into these folders and rename them:

# cd /opt/unetlab/addons/qemu/vios-159-3
# mv virtioa.qcow2
# cd /opt/unetlab/addons/qemu/viosl2-2019/
# mv vios_l2-adventerprisek9-m.ssa.high_iron_20190423.qcow2 virtioa.qcow2

That takes care of it. The images should now be in the node list:

Eve Ng Add New Node Cisco Ios Images

That’s it! We are now ready to build a Cisco SD-WAN lab.


You have now learned:

  • Which images you need to download.
  • How to create the required port groups for the EVE-NG virtual machine.
  • How to create an EVE-NG virtual machine with enough resources.
  • How to add the Cisco SD-WAN and IOS images to your EVE-NG installation.

I hope you enjoyed this lesson. You are now ready to build your lab and start learning Cisco SD-WAN.

Tags: ,

Forum Replies

  1. Hello René,
    Could you please share these all SD-WAN images for eve-ng to me?

  2. Hello Nyi Nyi

    In order to obtain the images, you need a Cisco Connection Online (CCO) account, also simply called a Cisco account. This is an account given to Cisco customers. Unfortunately, we are not able to share these images because they are protected by copyright.


  3. Hello everyone,

    I would like to know if I can build the same lab using VMware Workstation Pro instead of VMware ESxi, and if is possible which would be the steps in VMware Workstation Pro.

    Thanks !!

  4. Hi Rene,

    My eve-ng virtual machine is up and running in VMware Workstation, thanks for the help !!

1 more reply! Ask a question or join the discussion by visiting our Community Forum