Skip to main content

Run Proxmox VE 6.0 using Vagrant


This tutorial will show how to run Proxmox VE 6.0 using Vagrant. Vagrant is a tool for building and managing virtual machine environments and is especially useful for development and testing. Vagrant runs on everything from the Raspberry Pi to gaming laptops and the MacBook Air . We’ll also use Packer to build the Proxmox VE 6.0 Vagrant box.

This tutorial assumes you have a working installation of macOS or Ubuntu running on a client computer and that you have VirtualBox or libvirt installed.

Install Vagrant and Packer #

This is different depending on the platform you’re using.

On macOS, install Homebrew and install Vagrant and Packer:

$ /usr/bin/ruby -e "$(curl -fsSL"
$ brew install vagrant packer

On Ubuntu 19.10 (and earlier probably):

$ sudo apt install vagrant packer

Get the Vagrant Box Builder for Proxmox VE #

Make sure you have git installed, and clone rgl’s proxmox-ve repository:

$ git clone

Build the Proxmox VE 6.0 Vagrant Box #

$ cd proxmox-ve/
$ make build-virtualbox # if building for VirtualBox
$ make build-libvirt # if building for libvirt

Run a Proxmox VE Virtual Machine #

$ cd example/

If using VirtualBox, run:

$ vagrant up --provider=virtualbox

If using libvirt, run:

$ vagrant up --provider=libvirt

You should now have a virtual machine running Proxmox VE 6.0 managed by Vagrant. You should be able to access the web interface at

To destroy the virtual machine, simply run (while standing in the directory of your Vagrantfile):

$ vagrant destroy

Last Words #

If you’d like to learn more about Vagrant, see the documentation or read a book or two . Good luck! 😀

Revision #

2023-08-31 Revised language