Clone or download
Latest commit cb2df71 Jul 20, 2018
Failed to load latest commit information.
nbproject Update Aug 16, 2017
screenshots Add screenshots Aug 16, 2017
vagrant Update version number to 1.1.1 Jul 20, 2018
.gitignore Initial commit Sep 23, 2013 Fix Aug 16, 2017
build.xml Initial commit Sep 23, 2013

NetBeans Vagrant Plugin

This plugin provides support for Vagrant.

What's the Vagrant?

Please check the following site:


  • NetBeans 8.1 or newer
  • Vagrant 1.6.0 or newer


Please download a nbm from Plugin Portal:
NetBeans Vagrant Plugin


  • set a vagrant path to Options
  • add boxes
  • select a Project Node
  • run vagrant commands (e.g. up, init, suspend, e.t.c.)[1]

[1] There are three ways.

  • Right-click project node > Vagrant
  • Right-click Vagrant statusbar
  • Tools > Vagrant

Vagrant Root Settings

We can set Vagrant Root directory to project properties. (Right-click project > properties > Vagrant)

Default (i.e. Vagrant Root field is empty) is project directory.

We can also set Vagrant Root with Init Action.


Tools > Options > Miscellaneous > Vagrant


  • General : set a vagrant path
  • Boxes : manage boxes
  • Plugins : manage plugins

Available commands with context menu action

context menu

  • up
  • reload
  • suspend
  • resume
  • halt
  • init
  • status
  • share
  • ssh
  • ssh-config
  • destroy
  • provision
  • box add
  • plugin install
  • run command

Other commands

Please use run command action.

run command


add box


We can use specific url for boxes. Its format is the same as If you want to use original url, please set it to Options.


If you want to use the gist(or github) url, please use raw data. i.e.


We can remove boxes at Vagrant Options.


run command

We can manage plugins on Options window.


Show available plugins list with Install pluign window. Please select plugin, and click OK.


Plase select plugin name, and click uninstall button.


Plase select plugin name, and click update button.

Status Information

Vagrant status is displayed on the statusbar.If project root has a Vagrantfile, run vagrant status. Otherwise, just display "not created". We can reload the status display if we double-click it.

run command


Will take a little time when you access files or directories for your project at the first time.

Syntax Highlight for Vagrantfile

syntax highlight

Require Ruby plugin (

Action when project is closed

We can set an action when project is closed to the project properties.

  • none : do nothing
  • halt : run halt command
  • halt (ask) : popup a question dialog, if you push OK button, project will be closed

We can also run this action when we close the NetBeans. If you set halt (ask), cofirmation dialog is shown.

halt confirmation dialog

Status management window

This window can show vagrant status of opened projects as list. You can also run commands (e.g. up, halt, ...) for a project. Also show all machine status if you are using multiple machines.

If you want to reopen the window after you close it, please check Windows > Vagrant Status.


Please reboot NetBeans or reopen projects if status is not shown at the statusbar when you install this plugin at first.

Vagrant statuses


VM state is "aborted"

Please try to start the virtual machine.

Status display is wrong.

Please try to double-click on statusbar.

sudo command problem

For example, in case of sudo command is used within vagrant plugins: Probably, the following message will be shown "sudo: no tty present and no askpass program specified"

If passwd is visible, we can avoid this. But this is not good. So, please run vagrant command with terminal if this message is shown.

Vagrant could not detect VirtualBox!

If the below message is shown, please have a look at #45.

/usr/bin/vagrant up
The provider 'virtualbox' that was requested to back the machine
'default' is reporting that it isn't usable on this system. The
reason is shown below:

Vagrant could not detect VirtualBox! Make sure VirtualBox is properly installed.
Vagrant uses the VBoxManage binary that ships with VirtualBox, and requires
this to be available on the PATH. If VirtualBox is installed, please find the
VBoxManage binary and add it to the PATH environmental variable.


If you hava some problems, please submit them to the GitHub issue tracker . (Please don't submit them to NetBeans bugzilla.)

Version number

stable dev
pattern n.n.n n.n.n.n
e.g. 1.0.1

Stable version

Available on Plugin Portal.

Development version

I'll add new nbm for development to the following:


You should not use the development version except to test issues.


Common Development and Distribution License (CDDL) v1.0 and GNU General Public License (GPL) v2