2013-05-22 22:38:26 +00:00
# vagrant-cachier
A [Vagrant ](http://www.vagrantup.com/ ) plugin that helps you reduce the amount of
coffee you drink while waiting for boxes to be provisioned by sharing a common
package cache among similiar VM instances. Kinda like [vagrant-apt_cache ](https://github.com/avit/vagrant-apt_cache )
or [this magical snippet ](http://gist.github.com/juanje/3797297 ) but targetting
multiple package managers and Linux distros.
## Installation
Make sure you have Vagrant 1.2+ and run:
```
vagrant plugin install vagrant-cachier
```
2013-12-07 14:36:38 +00:00
## Quick start
2013-05-22 22:38:26 +00:00
2013-12-07 14:36:38 +00:00
The easiest way to set things up is just to enable [cache buckets auto detection ](http://fgrehm.viewdocs.io/vagrant-cachier/cache-buckets-auto-detection )
2013-05-22 22:38:26 +00:00
from within your `Vagrantfile` :
```ruby
Vagrant.configure("2") do |config|
config.vm.box = 'your-box'
config.cache.auto_detect = true
2013-06-11 23:23:46 +00:00
# If you are using VirtualBox, you might want to enable NFS for shared folders
# config.cache.enable_nfs = true
2013-05-22 22:38:26 +00:00
end
```
2013-12-07 14:36:38 +00:00
For more information please read the documentation available at
http://fgrehm.viewdocs.io/vagrant-cachier.
2013-05-22 22:38:26 +00:00
## Compatible providers
* Vagrant's built in VirtualBox provider
* [vagrant-lxc ](https://github.com/fgrehm/vagrant-lxc )
2013-08-05 16:14:44 +00:00
* [VMware providers ](http://www.vagrantup.com/vmware ) with NFS enabled (See
[GH-24 ](https://github.com/fgrehm/vagrant-cachier/issues/24 ) for more info)
2013-05-22 22:38:26 +00:00
2013-08-15 03:46:28 +00:00
2013-05-22 22:38:26 +00:00
## Contributing
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 new Pull Request
2013-11-12 11:00:55 +00:00
[![Bitdeli Badge ](https://d2weczhvl823v0.cloudfront.net/fgrehm/vagrant-cachier/trend.png )](https://bitdeli.com/free "Bitdeli Badge")