# HG changeset patch
# User Oleksandr Gavenko <gavenkoa@gmail.com>
# Date 1520159553 -7200
# Node ID 1223e50730076764c3331ee70f2d1854068dcf2d
# Parent  15e9cc9e054f6f4899b10d56563ba33f95d211dc
Managing boxes.

diff -r 15e9cc9e054f -r 1223e5073007 vagrant.rst
--- a/vagrant.rst	Sun Mar 04 12:16:23 2018 +0200
+++ b/vagrant.rst	Sun Mar 04 12:32:33 2018 +0200
@@ -14,6 +14,44 @@
 
 https://www.vagrantup.com/docs/other/environmental-variables.html
 
+Managing boxes
+==============
+
+Adding new box from catalog::
+
+  $ vagrant box add ubuntu/trusty64
+
+Checking for box updates::
+
+  $ cd $BOXDIR
+  $ vagrant box outdated
+
+Disable checking for update each time you call ``vagrant`` command::
+
+  Vagrant.configure("2") do |config|
+    config.vm.box_check_update = false
+  end
+
+Download box update::
+
+  $ vagrant box update
+
+.. note::
+   ``vagrant box update`` does not magicall updates your existing boxes. In just download
+   updated versions. To install new versio you need to destroy and install new boxes::
+
+     $ vagrant destroy
+     $ vagrant up
+
+To remove box at specific version::
+
+  $ vagrant box remove laravel/homestead --box-version 1.1.0
+
+https://www.vagrantup.com/docs/cli/box.html
+  Command: ``vagrant box``.
+https://www.vagrantup.com/docs/boxes/versioning.html
+  Box Versioning.
+
 Running individual provisioning scripts
 =======================================