diff --git a/website/source/docs/boxes/versioning.html.md b/website/source/docs/boxes/versioning.html.md index 717d7ec8c..88feee9ae 100644 --- a/website/source/docs/boxes/versioning.html.md +++ b/website/source/docs/boxes/versioning.html.md @@ -100,6 +100,8 @@ user has to manually enter a command to do it. Vagrant does not automatically prune old versions because it does not know if they might be in use by other Vagrant environments. Because boxes can -be large, you may want to actively prune them once in awhile using +be large, you may want to actively prune them once in a while using `vagrant box remove`. You can see all the boxes that are installed using `vagrant box list`. + +Another option is to use `vagrant box prune` command to remove all installed boxes that are outdated and not currently in use. \ No newline at end of file diff --git a/website/source/docs/cli/box.html.md b/website/source/docs/cli/box.html.md index 5320c1c99..c2da385d4 100644 --- a/website/source/docs/cli/box.html.md +++ b/website/source/docs/cli/box.html.md @@ -150,6 +150,24 @@ with the `--all` flag. name. This is only required if a box is backed by multiple providers. If there is only a single provider, Vagrant will default to removing it. + +# Box prune + +**Command: `vagrant box prune`** + +This command removes old versions of installed boxes. If the box in currently in use vagrant will ask you if you to confirm. + +## Options + +* `--provider PROVIDER` - The specific provider type for the boxes to destroy. + +* `--dry-run` - Only print the boxes that would be removed. + +* `--name NAME` - The specific box name to check for outdated versions. + +* `--force` - Destroy without confirmation even when box is in use. + + # Box Repackage **Command: `vagrant box repackage NAME PROVIDER VERSION`**