Skip to main content

Adding EVE-NG Device Images

··412 words·2 mins· 0 · 0 ·
Guides eve-ng networking
Table of Contents

Prerequisites #

  1. EVE-NG Server
  2. WinSCP or some way to SFTP into your server

Background #

The only device image that comes with EVE-NG preinstalled is the VPCS image, providing an extremely simple, CLI based virtual PC that can basically just send pings and test DHCP. If we want to actually get some value out of this program, we will have to import device images.

A full list of supported devices can be found here

1.0 Acquire and Transfer>

1.0 Acquire and Transfer #

1.1 Getting Images>

1.1 Getting Images #

Due to legal reasons, I can not directly host the device images on this site.

I will however, share with you the exact file names that you might want to search for…

Layer 2 (Switch)Layer 3 (Router)

If you are just trying to get some routers and switches going quickly, i’d prioritize the items that i’ve linked to their search results.

1.2 Transfer>

1.2 Transfer #

Now, using a program such as WinSCP, establish a session with your server, logging in as root

In this example, I’ll be loading vios-adventerprisek9-m.SPA.156-2.T, this is a popular L2 switch image that was released by Cisco for their own network emulation software called VIRL or CML.

Create a directory on your server at /opt/unetlab/addons/qemu named vios-adventerprisek9-m.SPA.156-1.T and move the contents of your device image folder over to it. In depth instructions on naming conventions for specific images can be found on EVE-NG’s website.

adding images to eve-ng
Transfering ‘virtioa.qcow2’ from my PC to EVE-NG

EVE-NG will look for the correctly named folder, in this case vios-adventerprisek9-m.SPA.156-1.T , and expect the file in that folder to be the device it should be. Whatever your actual file name is, make sure it is renamed to virtioa.qcow2

2.0 Fix Permissions & Verify>

2.0 Fix Permissions & Verify #

2.1 Fix Permissions>

2.1 Fix Permissions #

The newly moved file needs to have its permissions modified to work correctly with the EVE-NG application. Luckily, there is an easy-to-use built in script that will do this for you.

Run this command from your EVE-NG server CLI

sudo /opt/unetlab/wrappers/unl_wrapper -a fixpermissions

2.2 Verify Functionality>

2.2 Verify Functionality #

Open up the EVE-NG GUI and drop in your node. If it starts, you’re done!

eve-ng vios
Creating a new vIOS node
10 vios routers running at once
Ten vIOS routers running concurrently

If you need more assistance, feel free to leave a comment or have a look at the official documentation found here

Thanks for reading!