Getting Started

To install Cumulus VX, first download and install the preferred hypervisor platform or development environment, then download the appropriate Cumulus VX image from the Cumulus website. After you have downloaded both the preferred hypervisor and Cumulus VX image, you can import the VX image to create the necessary VMs. This section provides an installation process overview, with next step links for each supported hypervisor or development environment.

Download the Cumulus VX Image

Cumulus VX images for all supported platforms are available from the Cumulus Networks website.

Each disk image contains a single VM for a standalone switch. You can clone the image to build the test network.

Download and Install the Hypervisor/Developer Environment

If the preferred hypervisor or developer environment is already installed, go to Configure the VMs, below.

To download and install the preferred hypervisor or development environment, follow the relevant links below. Detailed installation instructions are available on the download websites:

HypervisorDownload Location
VMware vSphere - ESXi 5.5
VMware Fusion
VMware Workstation
KVMFor package installation instructions, refer to


Development EnvironmentDownload LocationSupported Hypervisors
GNS3, VirtualBox

Configure the VMs

After you have downloaded the hypervisor or development environment and the Cumulus VX image, follow the relevant link below for detailed setup instructions:

Log in to the VM

The Cumulus VX VM has these default login credentials:

  • User name: cumulus
  • Password: CumulusLinux!