From 701eb1425a88cc61f182b07f8ce3986610ac5400 Mon Sep 17 00:00:00 2001 From: Seth Vargo Date: Mon, 20 Jun 2016 09:22:37 -0400 Subject: [PATCH] Updated Installing Vagrant from Source (markdown) --- Installing-Vagrant-from-Source.md | 66 +------------------------------ 1 file changed, 1 insertion(+), 65 deletions(-) diff --git a/Installing-Vagrant-from-Source.md b/Installing-Vagrant-from-Source.md index 400b36f..0f32f50 100644 --- a/Installing-Vagrant-from-Source.md +++ b/Installing-Vagrant-from-Source.md @@ -1,65 +1 @@ -**Installing Vagrant from source is only recommended for Advanced users with Ruby experience! We recommend downloading a pre-compiled Vagrant from https://www.vagrantup.com/downloads.html instead.** - -You can install from source to get the bleeding edge of Vagrant. Please note that installing Vagrant from source is rather difficult, especially if you do not have experience in Ruby. - -## Install Ruby -First, you must have a modern Ruby (>= 2.0) in order to develop on Vagrant. This guide will not discuss how to install and manage Ruby. However, beware of the following pitfalls: - -- Do **NOT** use the system Ruby - use a Ruby version manager like rvm, chruby, etc -- Ensure you have the latest version of Rubygems -- Ensure you have installed a version of [Bundler](https://bundler.io) that is compatible with Vagrant* - -\* The bundler constraint is a floating requirement in Vagrant. You will need to inspect the [vagrant.gemspec](https://github.com/mitchellh/vagrant/blob/master/vagrant.gemspec) file to determine the version when you are compiling from source. For example, if the gemspec says ` "bundler", ">= 1.5.2", "<= 1.10.6" `, you will need to install a version of Bundler that is higher than or equal to 1.5.2 and lower than or equal to 1.10.6. - -You can install a specific version of bundler with the following command: - -```shell -gem install bundler --version '<= 1.10.6' -``` - -## Clone Vagrant -Clone Vagrant's repository from GitHub into the directory where you keep code on your machine: - - -```shell -$ git clone https://github.com/mitchellh/vagrant.git -``` - -Next, `cd` into that path. All commands will be run from this path: - -```shell -$ cd /path/to/your/vagrant/clone -``` - -Run the `bundle` command with a required version* to install the requirements: - -```shell -$ bundle _1.10.6_ install -``` - -You can now run Vagrant by running `bundle exec vagrant` from inside that directory. - -## Use dev version -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: - -```shell -$ bundle --binstubs exec -``` - -This will generate files in `exec/`, including `vagrant`. You can now specify the full path to the `exec/vagrant` anywhere on your operating system: - -```shell -$ /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: - -```shell -$ 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. \ No newline at end of file +This page has moved to the [Vagrant official documentation for installing from source](https://www.vagrantup.com/docs/installation/source.html). \ No newline at end of file