This plugin is up for adoption! We are looking for new maintainers. Visit our Adopt a Plugin initiative for more information.

This plugin integrates Jenkins with VirtualBox (version 3, 4.0, 4.1, 4.2 and 4.3) virtual machine.


VirtualBox cloud

The first step is the VirtualBox cloud configuration:

  1. Configure the VirtualBox server, that allows to remotely manage VMs, and start it.


  2. Manage Jenkins -> Configure System -> Cloud -> Add a new cloud -> VirtualBox

  3. Set Name, URL, Username and Password

  4. Test connection

    If it doesn't work, then you can try to disable authentication library by executing following command on VirtualBox host:
    VBoxManage setproperty websrvauthlibrary null

    If you got this error:

    Runtime modeler error: Wrapper class org.virtualbox_3_1.IWebsessionManagerLogon is not found. Have you run APT to generate them?

    Then you should upgrade Java (probably it is a bug in jax-ws). Also note that plugin was tested on Java 1.6.0_19.

VirtualBox slave

Now you can setup your nodes in Jenkins and use them to build your projects:

  1. Add Manage Jenkins -> Manage Nodes -> New Node
  2. Set Node name for VirtualBox Slave
  3. Select VirtualBox Host, Virtual Machine Name and Virtual Machine Type


  1. restore snaphot (beta version available in the github repository as branch (snap))
  2. build wrapper


Version 0.7 (October 21, 2013)
  • Added VirtualBox 4.3 support
Version 0.6 (October 7, 2012)
Version 0.5 (September 21, 2012)
Version 0.4.6 (March 1, 2012)
  • Added Virtual Machine Types 'gui' and 'sdl' (issue #9752)
Version 0.4.4 (February 22, 2012)
  • Added support for VirtualBox version 4.0 and 4.1 (issue #8634)
Version 0.2.1 (April 27, 2010)
  • Fixed critical bug, which prevented creation of node (JENKINS-6375)
Version 0.2 (April 18, 2010)
  • Used official virtualbox library, reimplemented launch process
  • Fixed delegation to user-specified launcher (JENKINS-6276)
  • Added type of start - headless or vrdp (JENKINS-6279)
  • VirtualBoxBuildWrapper disabled
Version 0.1 (April 12, 2010)
  • Added VirtualBoxBuildWrapper
  • Added VirtualBoxSlave
  • Tested on VirtualBox 3.1.6 r59338, Jenkins 1.346, Java 1.6.0_19
  • First version published