Use Proxmox virtual machines as agents in Jenkins

Proxmox Plugin ChangeLog Installs License Build Status


This plugin allows the use of Proxmox virtual machines as agents in Jenkins.


  • Only Qemu virtual machines supported (at the moment).
  • No option to avoid rolling back to a snapshot on agent start up.
  • No checking on virtual machine ready state/errors during rollback.


Datacenter cloud

To add a new Proxmox datacenter cloud, click on "Manage Jenkins" then "Configure System". In the "Cloud" section click "Add cloud" and select "Datacenter".

Virtual machine agents

To add agents click on "Manage Jenkins" then "Manage Nodes". Select the node type "Agent virtual machine running on a Proxmox datacenter." and enter a name for the node.

Manually Installing

  1. Clone this repo.
  2. Run mvn clean package.
  3. Go to Jenkins in a web browser.
  4. Click on "Manage Jenkins", select "Manage Plugins".
  5. Click on the "Advanced" tab then upload the file target/proxmox.hpi under the "Upload Plugin" section.

To run directly a Jenkins test instance with the plugin, run mvn hpi:run.