KB 471509 - 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
| Item | Details |
|---|---|
| Hypervisor | Proxmox VE 7.x / 8.x |
| Image Type | cumulus-linux-5.x-amd64-qemu.qcow2 |
| Minimum VM Specs | 2 vCPUs, 2GB RAM, 6GB disk |
| Boot Mode | SeaBIOS (Legacy BIOS) — NOT UEFI |
| Disk Bus | VirtIO or SATA |
2. Download the Cumulus VX QCOW2 Image
Download from the NVIDIA Cumulus website:
Upload it to the Proxmox node using:
Option A — Proxmox GUI → Datacenter → Storage → Upload
or
Option B — SCP/rsync:
3. Create a New VM (Empty VM First)
In Proxmox UI:
-
Create VM
-
Name:
CUMULUS-VX OS Tab → Do NOT select any ISO
-
Set: Do not use any media
-
System Tab
-
BIOS: SeaBIOS
-
Machine: i440fx (recommended)
-
SCSI Controller: VirtIO SCSI (default)
-
Hard Disk Tab
-
Bus/Device: Do not create a disk
-
-
CPU: 2 cores (or more depending on need)
-
Memory: 2048–8192 MB (8GB ideal)
-
Network: VirtIO (bridge=vmbr0)
-
Finish creation.
Example VMID in this guide: 138
4. Import the QCOW2 Disk
Move into your image folder:
Import the QCOW2 into the local-lvm storage:
Proxmox outputs something like:
5. Attach the Imported Disk to the VM
Attach as virtio0:
Set boot order:
6. Final VM Configuration (Expected)
In Proxmox → Hardware, you should see:
Make sure to remove unused disks:
7. Start the VM
Start from GUI or run:
Open the console — Cumulus should boot cleanly:
Default login:
You will be prompted to change the password at first login.
Related Articles
KB 187001 - 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 ...KB 483001 - 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 ...KB 159001 - 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 ...KB 461110 - 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 ...KB 787224 - 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, ...
Recent Articles
KB-630208 | How to use Find and Locate to search for files in Linux
Purpose To provide Linux administrators and Field Engineers with guidance on using the find and locate utilities to efficiently search for files and directories within a Linux filesystem based on criteria such as name, type, size, timestamps, ...KB-630164 | How to use rsync to Synchronize Files
Purpose To provide a clear and practical procedure for using the rsync utility to synchronize files and directories between local systems and remote hosts, including push and pull operations, while preserving file attributes and optimizing data ...KB-630107 | How to create a Linux swap file
Purpose To provide Field Engineers and Linux administrators with a standardized procedure for creating, configuring, and validating a Linux swap file. This procedure helps ensure sufficient virtual memory is available when physical RAM is exhausted ...MSI All-in-One (AIO) PC – Physical Damage Policy for Warranty Claims
MSI All-in-One (AIO) PC – Physical Damage Policy for Warranty Claims MSI's standard warranty does not cover physical or accidental damage to an All-in-One (AIO) PC. If the damage is determined to be caused by external factors rather than a ...KB 134833 - Troubleshooting NVSM Alert NV-CPU-XX – Unrecoverable CPU Internal Error
Purpose This document provides a general troubleshooting procedure for the NVIDIA System Management (NVSM) alert NV-CPU-XX, which indicates that a CPU has reported an internal error. The article outlines how to verify whether the alert represents an ...
Popular Articles
CP Plus Camera and NVR Configuration
NVR Configuration The CP Plus Pro Series of NVRs have been meticulously designed for providing you with upgraded performance and higher recording quality in your IP video surveillance solution. The robust processor that has been inculcated in this ...KB 775235 - Kerberos Authentication – Overview
What is Kerberos? Kerberos is a secure authentication method used in our Active Directory (AD) environment (mbuzztech.com). It allows users to: Access multiple systems without re-entering passwords (Single Sign-On – SSO) Log in once Where We Use It ...How to Remove and Reinstall NVIDIA Drivers on Ubuntu
This article provides step by step guide to completely remove existing NVIDIA drivers and reinstall specific version of the NVIDIA driver on the Ubuntu system Prerequisites Administrative (sudo) access to the Ubuntu system. Internet access to ...KB 692001 - Personal Computers and Servers - Classification and Point of Contact
We can classify the computers that MBUZZ handles based on their form-factor as below: Tower Workstations, Desktops, Gaming PCs and SFF (Small form factor) PCs fall under this category. These are computers people would use on a desk and rarely move. ...KB 298031 - M.2 SSD Tier List
The sequential read and write speeds, which are usually the most advertised number, are not a proper benchmark of real-world performance or the quality of an SSD. This article categorizes and tiers SSDs based on factors like the type of NAND flash, ...