Vagrant plugin to load environment variables from .env into ENV
Switch branches/tags
Clone or download
gosuri Merge pull request #5 from schlueter/patch-1
Join the path with File.join
Latest commit fa954ef Dec 16, 2015

Vagrant ENV Plugin

This is a Vagrant plugin to load environment variables from .env into ENV. More information on why and how we use this plugin is detailed in this post


  • Vagrant 1.7.4 or higher


Install the lastest version using standard vagrant plugin installation method:

$ vagrant plugin install vagrant-env

To install an older version of the plugin use vagrant plugin install vagrant-env --plugin-version VERSION


After installing, add your application configuration to your .env file in the root of your project

$ echo BOX_NAME=hashicorp/precise64 > .env

Create a a Vagrantfile that looks like the following, ensure to add config.env.enable and fill in your information where necessary. Check out example for reference

Vagrant.configure("2") do |config|
  config.env.enable # enable the plugin = ENV['BOX_NAME']

Additionally, You may also add export in front of each line so you can source the file in bash:


Should I commit my .env file?

It is recommended that you store development-only settings in your .env file, and commit it to your repository. Make sure that all your credentials for your development environment are different from your other deployments. This makes it easy for other developers to get started on your project, without compromising your credentials for other environments.


  1. Fork it ( )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request