Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Ruby gem for interacting with the api from inside vagrant

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 lib
Octocat-spinner-32 .gitignore
Octocat-spinner-32 Gemfile
Octocat-spinner-32 Rakefile
Octocat-spinner-32 vagrantboxes.gemspec


This application extends the vagrant command line tool to allow for searching the repository of base boxes.


  • List all currently available boxes:
    vagrant vagrantboxes search
  • Do simple text searches:
    vagrant vagrantboxes search centos 
  • Do slightly more complex text searches:
    vagrant vagrantboxes search "debian puppet" 
  • Show all the details of a particular box:
    vagrant vagrantboxes show 1
  • Show only the url of a particular box:
    vagrant vagrantboxes url 1
  • Download a box listed on
    vagrant vagrantboxes add 1


Here's a simple example of the output:

vagrant vagrantboxes search centos
3    centos 5.5      
6    opscode centos 5
7    opscode ubuntu 10.04
9    puppet centos 5.5 64
10   puppet centos 4 64
21   centos 5.6 32   


The easiest way of installing is to use the gem.

gem install vagrantboxes
Something went wrong with that request. Please try again.