Installing Vagrant from source is an advanced topic and is only recommended when using the official installer is not an option. This page details the steps and prerequisites for installing Vagrant from source.
You must have a modern Ruby (>= 2.2) in order to develop and build Vagrant. The specific Ruby version is documented in the Vagrant's
gemspec. Please refer to the
vagrant.gemspec in the repository on GitHub, as it will contain the most up-to-date requirement. This guide will not discuss how to install and manage Ruby. However, beware of the following pitfalls:
Clone Vagrant's repository from GitHub into the directory where you keep code on your machine:
$ git clone https://github.com/hashicorp/vagrant.git
cd into that path. All commands will be run from this path:
$ cd /path/to/your/vagrant/clone
bundle command with a required version* to install the requirements:
$ bundle install
You can now run Vagrant by running
bundle exec vagrant from inside that directory.
In order to use your locally-installed version of Vagrant in other projects, you will need to create a binstub and add it to your path.
First, run the following command from the Vagrant repo:
$ bundle --binstubs exec
This will generate files in
vagrant. You can now specify the full path to the
exec/vagrant anywhere on your operating system:
$ /path/to/vagrant/exec/vagrant init -m hashicorp/precise64
Note that you will receive warnings that running Vagrant like this is not supported. It's true. It's not. You should listen to those warnings.
If you do not want to specify the full path to Vagrant (i.e. you just want to run
vagrant), you can create a symbolic link to your exec:
$ ln -sf /path/to/vagrant/exec/vagrant /usr/local/bin/vagrant
When you want to switch back to the official Vagrant version, simply remove the symlink.
© 2010–2018 Mitchell Hashimoto
Licensed under the MPL 2.0 License.