Skip to content
This repository has been archived by the owner on Feb 13, 2023. It is now read-only.

Commit

Permalink
Issue #1774: Add docs for building a custom Vagrant base box.
Browse files Browse the repository at this point in the history
  • Loading branch information
geerlingguy committed Nov 21, 2018
1 parent 6aae52e commit 69a4423
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 0 deletions.
11 changes: 11 additions & 0 deletions docs/other/custom-base-box.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
You can build a custom Vagrant base box to help speed up the provisioning time for Drupal VM for your project, or if you have other specilized requirements, like:

- You need larger virtual disk image size for your VM
- You need a base box for a provider not supported by the default Drupal VM boxes (e.g. Parallels, VMware Fusion, AWS, etc.)
- You need to inject certain software or configuration which is difficult to do using Drupal VM alone.

By default, Drupal VM uses the [`geerlingguy/drupal-vm`](https://app.vagrantup.com/geerlingguy/boxes/drupal-vm) Vagrant base box, but you can use any base box which has at least a minimal OS installation supported by Drupal VM (e.g. CentOS, Ubuntu, Debian).

This base box is built using the Packer configuration here: [Packer Build - Drupal VM](https://github.com/geerlingguy/packer-drupal-vm).

In order to build your own custom base box, fork the Packer project linked above, then follow the instructions included in its README to install Packer and build the base box. Then update your `config.yml` to point to your own custom box by overriding the `vagrant_box` variable.
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,7 @@ pages:
- 'Vagrant LXC provider': 'other/vagrant-lxc.md'
- 'Improving Performance': 'other/performance.md'
- 'Docker': 'other/docker.md'
- 'Custom Vagrant Base Box': 'other/custom-base-box.md'
- 'BigPipe with Drupal VM': 'other/bigpipe.md'
- 'Drupal multisite': 'deployment/multisite.md'
- 'Drupal 6 Notes': 'other/drupal-6.md'
Expand Down

0 comments on commit 69a4423

Please sign in to comment.