Installing Cumulus VX on Proxmox VE

Installing Cumulus VX on Proxmox VE

This document describes how to deploy NVIDIA Cumulus VX (Cumulus Linux 5.x) on Proxmox VE using the QCOW2 disk image provided by NVIDIA.

Cumulus VX allows you to simulate a Cumulus Linux switch using KVM.

1. Requirements

ItemDetails
HypervisorProxmox VE 7.x / 8.x
Image Typecumulus-linux-5.x-amd64-qemu.qcow2
Minimum VM Specs2 vCPUs, 2GB RAM, 6GB disk
Boot ModeSeaBIOS (Legacy BIOS) — NOT UEFI
Disk BusVirtIO or SATA

2. Download the Cumulus VX QCOW2 Image

Download from the NVIDIA Cumulus website:
cumulus-linux-5.3.1-vx-amd64-qemu.qcow2

Upload it to the Proxmox node using:

Option A — Proxmox GUI → Datacenter → Storage → Upload
or
Option B — SCP/rsync:

scp cumulus-linux-5.3.1-vx-amd64-qemu.qcow2 root@proxmox:/var/lib/vz/images/

3. Create a New VM (Empty VM First)

In Proxmox UI:

  1. Create VM

  2. Name: CUMULUS-VX

  3. OS Tab → Do NOT select any ISO

    • Set: Do not use any media

  4. System Tab

    • BIOS: SeaBIOS

    • Machine: i440fx (recommended)

    • SCSI Controller: VirtIO SCSI (default)

  5. Hard Disk Tab

    • Bus/Device: Do not create a disk

  6. CPU: 2 cores (or more depending on need)

  7. Memory: 2048–8192 MB (8GB ideal)

  8. Network: VirtIO (bridge=vmbr0)

  9. Finish creation.

Example VMID in this guide: 138

4. Import the QCOW2 Disk

Move into your image folder:
cd /var/lib/vz/images/138

Import the QCOW2 into the local-lvm storage:

qm importdisk 138 cumulus-linux-5.3.1-vx-amd64-qemu.qcow2 local-lvm

Proxmox outputs something like:

successful import disk 'local-lvm:vm-138-disk-1'

5. Attach the Imported Disk to the VM

Attach as virtio0:
qm set 138 --virtio0 local-lvm:vm-138-disk-1

Set boot order:

qm set 138 --boot order=virtio0

6. Final VM Configuration (Expected)

In Proxmox → Hardware, you should see:

Make sure to remove unused disks:

qm set 138 --delete unused0

7. Start the VM

Start from GUI or run:
qm start 138

Open the console — Cumulus should boot cleanly:

Cumulus Linux GNU/Linux
Login:

Default login:

user: cumulus
pass: CumulusLinux!

You will be prompted to change the password at first login.

    • Related Articles

    • Container on Proxmox

      Upload Container Template on Proxmox Storage Go to the server Select storage in which you want upload template Go to "CT Templates" tab Click on "Templates" button Search for Templates You can search any kind of Linux flavour Select Package and click ...

    • Upload ISO file on Proxmox

      How to Upload Operating System ISO file on Proxmox Steps to upload ISO file Go to the web browser and login to proxmox account using credential's Select the server in which ISO should be upload Select the storage location in which ISO should be ...

    • Create VM on Proxmox.

      Steps to create VM. Login to Proxmox account with credentials. In home screen Top Right click on "create VM". Here create: Virtual Machine wizard is appear. Select the server in which you want to create VM. VM ID is auto-generated. Provide any name ...

    • Some Basic Configuration on Proxmox

      Delete VM on Proxmox Go to the server Select the VM which you want to delete Select the more option (Shown in picture) Click on the Remove Provide the VM ID number Click on Remove button, VM will be delete from server Create a Template Go to the ...

    • How to Collect Logs from NVIDIA Cumulus Linux Switch

      Purpose This article describes how to collect diagnostic logs from a switch running NVIDIA Cumulus Linux. These logs are typically required by NVIDIA Networking Support for troubleshooting switch-level issues such as port flaps, routing problems, ...