From 8c7e03d5fec9e6394df25bc43140d421d1783d0a Mon Sep 17 00:00:00 2001 From: Cory Flanigan Date: Tue, 16 Mar 2010 10:36:18 -0400 Subject: [PATCH] Add filesystem location of downloaded vagrant boxes --- docs/boxes.md | 3 ++- docs/getting-started/boxes.md | 13 +++++++------ 2 files changed, 9 insertions(+), 7 deletions(-) diff --git a/docs/boxes.md b/docs/boxes.md index ac9cace94..7c5425823 100644 --- a/docs/boxes.md +++ b/docs/boxes.md @@ -28,7 +28,8 @@ $ vagrant box add ubuntu_base http://files.vagrantup.com/base.box The name used with the `vagrant box add` command is the name used to reference the box from that point forward. Any box can be named anything -you want. +you want. Boxes that are added using `vagrant box add` are global to the +vagrant install, and they are stored at `~/.vagrant/boxes` on the local filesystem. **Note:** The default Vagrantfile created with `vagrant init` defaults to using a box named "base." This is why in the getting started guide, the diff --git a/docs/getting-started/boxes.md b/docs/getting-started/boxes.md index 7e737170f..f31185f84 100644 --- a/docs/getting-started/boxes.md +++ b/docs/getting-started/boxes.md @@ -32,9 +32,9 @@ while box installation is covered in more detail: $ vagrant box add getting_started http://files.vagrantup.com/getting_started.box {% endhighlight %} -Installed boxes are global to the current vagrant installation. This means -that once the rails box has been added, it can be used by multiple projects -at the same time. Each project uses the box as a _base_ only, so once the +Installed boxes reside in ~/.vagrant/boxes, and they are global to the current vagrant +installation. This means that once the rails box has been added, it can be used by +multiple projects at the same time. Each project uses the box as a _base_ only, so once the project VM is created, modifications can be made without affecting other projects which may use the same box. @@ -47,8 +47,9 @@ the filename and logical name are equal in this case. ## Removing Boxes Just as easily as they're added, boxes can be removed as well. The following -is an example command to remove a box. **Do not run this command if you're -following the guide. It is just an example.** +is an example command to remove a box. + +**Do not run this command if you're following the guide. It is just an example.** {% highlight bash %} $ vagrant box remove my_box @@ -87,4 +88,4 @@ $ vagrant up ... $ vagrant down ... -{% endhighlight %} \ No newline at end of file +{% endhighlight %}