Skip to content

Commit

Permalink
Update to implement #64
Browse files Browse the repository at this point in the history
Thanks to Don (Cutaway) for the update recommendations.
  • Loading branch information
secureideas authored and mgillam committed Mar 15, 2019
1 parent 0cc4eef commit dc5057b
Showing 1 changed file with 14 additions and 1 deletion.
15 changes: 14 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,11 +12,18 @@ A [video tutorial](https://www.youtube.com/watch?v=3a3qOFubfGg) is available sho
- Vagrant - https://www.vagrantup.com/
- Virtualization Software - The base vagrant box used supports virtualbox, vmware, and parallels, but testing at this time has been solely on virtualbox - https://www.virtualbox.org/
- vagrant-vbguest plugin for vagrant (virtualbox only) - this automatically installs guest extensions which provide support for higher display resolutions, as well as other conveniences like clipboard sharing - https://github.com/dotless-de/vagrant-vbguest
- Disable Hyper-V (Windows and Virtualbox only) - follow the Resolution instructions provided by Microsoft to disable and enable Hyper-V (requires reboot) - https://support.microsoft.com/en-us/help/3204980/virtualization-applications-do-not-work-together-with-hyper-v-device-g

## Initial Install
1. Make sure you have the prereqs listed above. Webpwnized has made some helpful [YouTube video instructionals](https://www.youtube.com/watch?v=MCqpTpxNSlA&list=PLZOToVAK85Mru8ye3up3VR_jXms56OFE5) for getting Vagrant and VirtualBox with vbguest plugin installed in case you have not done so before.
2. Clone this repository.
3. From a command-line terminal in the project directory, run the command `vagrant up`. Then sit back and wait for it to finish. Immediately after the first time start up it is recommend you do a restart using `vagrant reload`. Just running the `vagrant up` will build the primary target, which is a single VM with both the user environment and the targets. You can run `vagrant up userenv` and `vagrant up target` to build seperate virtual machines for those purposes.
3. From a command-line terminal in the project directory, run the command `vagrant up`. Then sit back and wait for it to finish. NOTE: The Guest VM's window will open with the CLI while provisioning is still ongoing. It's best to leave it alone until the vagrant up command fully completes.
4. Immediately after the first time start up it is recommend you do a restart using vagrant reload.

## Running Separate User / Target Systems
- Just running the `vagrant up` will build the primary target, which is a single VM with both the user environment and the targets.
- You can run `vagrant up userenv` and `vagrant up target` to build seperate virtual machines for those purposes.)

**NOTE: The Guest VM's window will open with the CLI while provisioning is still ongoing. It's best to leave it alone until the `vagrant up` command fully completes.**

### Provisioning Scripts
Expand All @@ -38,6 +45,12 @@ A file selector window will open. Select the *chrome_bookmarks.html* file in th

Some of the target environments need to be initialized before use. Use their setup or Reset DB links to do this.

## Virtualbox Display
- To automatically adjust the display resolution, do the following:
- Select Virtualbox Menu -> View
- Click Auto-Resize Guest Display
- Resize Virtualbox window and display should change to fit window size.

# License
The scripts and resources belonging to this project itself are licensed under the GNU Public License version 3 (GPL3).
All software loaded into the VM, including the tools, targets, utilities, and operating system itself retain their original license agreements.
Expand Down

0 comments on commit dc5057b

Please sign in to comment.