Setting up the lab

We’ll set up a lab using VirtualBox and Vagrant, with a virtual Arista device, and get some sample files for the following steps.

Working directory

Create a directory for your files anywhere on your machine.

Arista vEOS

The Arista EOS image can be downloaded for free from the Arista site.

Create an account at, and go to

Download the latest “vEOS-lab-<version>” listed in the vEOS folder at the bottom of the page.

Add it to your vagrant box list, changing the <version>:

$ vagrant box add --name vEOS-lab-<version>-virtualbox ~/Downloads/vEOS-lab-<version>
$ vagrant box list
vEOS-lab-quickstart (virtualbox, 0)

You can delete the downloaded .box file once you have added it, as vagrant box add copies downloaded file to a designated directory (e.g., for Mac OS X and Linux: ~/.vagrant.d/boxes, Windows: C:/Users/USERNAME/.vagrant.d/boxes).

Starting Vagrant

Create a file named Vagrantfile (no file extension) in your working directory with the following content (replace VEOS_BOX by your downloaded EOS version):

# Vagrantfile for the quickstart tutorial

# Script configuration:
# Arista vEOS box.
# Please change this to match your installed version
# (use `vagrant box list` to see what you have installed).
VEOS_BOX = "vEOS-lab-4.15.5M-virtualbox"

Vagrant.configure(2) do |config|

  config.vm.define "base" do |base|
    # This box will be downloaded and added automatically if you don't
    # have it already. = "hashicorp/precise64" :forwarded_port, guest: 22, host: 12200, id: 'ssh' "private_network", virtualbox__intnet: "link_1", ip: "" "private_network", virtualbox__intnet: "link_2", ip: ""
    base.vm.provision "shell", inline: "apt-get update; apt-get install lldpd -y"

  config.vm.define "eos" do |eos| = VEOS_BOX :forwarded_port, guest: 22, host: 12201, id: 'ssh' :forwarded_port, guest: 443, host: 12443, id: 'https' "private_network", virtualbox__intnet: "link_1", ip: "", auto_config: false "private_network", virtualbox__intnet: "link_2", ip: "", auto_config: false


The above content is also available on GitHub.

This Vagrantfile creates a base box and a vEOS box when you call vagrant up:

$ vagrant up --provider virtualbox
... [output omitted] ...

$ vagrant status
Current machine states:
base                      running (virtualbox)
eos                       running (virtualbox)

You may see some errors when the eos box is getting created [1].


  • After running vagrant up, ensure that you can ssh to the box with vagrant ssh eos.
  • If you receive the warning “eos: Warning: Remote connection disconnect. Retrying…”, see this StackOverflow post.

Sample files

There are some sample Arista vEOS configuration files on GitHub. You can download them to your machine by copying them from GitHub, or using the commands below:

$ for f in new_good.conf merge_good.conf merge_typo.conf; do
$   wget$f
$ done

(Note: please open a GitHub issue if these URLs are invalid.)

[1]Currently, vagrant up with the eos box prints some warnings: “No guest additions were detected on the base box for this VM! Guest additions are required for forwarded ports, shared folders, host only networking, and more. If SSH fails on this machine, please install the guest additions and repackage the box to continue. This is not an error message; everything may continue to work properly, in which case you may ignore this message.” This is not a reassuring message, but everything still seems to work correctly.