diff --git a/docs/getting-started/boxes.md b/docs/getting-started/boxes.md index f31185f84..7cb14371c 100644 --- a/docs/getting-started/boxes.md +++ b/docs/getting-started/boxes.md @@ -25,15 +25,15 @@ for all the servers, so we'll instead cover a more simple case, although the rails box was created completely with Vagrant provisioning. Vagrant supports adding boxes from both the local filesystem and an -HTTP URL. Beginning running the following command so it can begin downloading +HTTP URL. Begin running the following command so it can begin downloading while box installation is covered in more detail: {% highlight bash %} $ vagrant box add getting_started http://files.vagrantup.com/getting_started.box {% endhighlight %} -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 +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,7 +47,7 @@ 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. +is an example command to remove a box. **Do not run this command if you're following the guide. It is just an example.** diff --git a/docs/getting-started/packaging.md b/docs/getting-started/packaging.md index dc5b50c2a..e001b5eae 100644 --- a/docs/getting-started/packaging.md +++ b/docs/getting-started/packaging.md @@ -42,6 +42,18 @@ Vagrant::Config.run do |config| end {% endhighlight %} +
+ When an OS is installed, it typically sets up the MAC address associated
+ with the eth0
network interface, which allows the VM to connect to the
+ internet. But when importing a base, VirtualBox changes the MAC address
+ to something new, which breaks eth0
. The MAC address of the base must
+ be persisted in the box Vagrantfile so that Vagrant can setup the MAC address
+ to ensure internet connectivity.
+