github
/
metasploitable3
mirror of https://github.com/rapid7/metasploitable3
1
Fork 0
Code Releases Activity
metasploitable3/README.md

40 lines
2.5 KiB
Markdown
Raw Normal View History

Initial commit.
2016-08-30 17:53:02 +02:00
# Metasploitable3
Update Vagrantfile to remove base file's tutorial comments. Update README.md Add LICENSE and COPYING files
2016-09-07 20:57:55 +02:00
Metasploitable3 is a VM that is built from the ground up with a large amount of security vulnerabilities. It is intended to be used as a target for testing exploits with [metasploit](https://github.com/rapid7/metasploit-framework).
Metasploitable3 is released under a BSD-style license. See COPYING for more details.
## Building Metasploitable 3
Requirements:
* [Packer](https://www.packer.io/intro/getting-started/setup.html)
Update README.md Vagrant 1.8.1 is no longer required
2016-11-03 11:48:41 +01:00
* [Vagrant](https://www.vagrantup.com/docs/installation/)
Update Vagrantfile to remove base file's tutorial comments. Update README.md Add LICENSE and COPYING files
2016-09-07 20:57:55 +02:00
* [Vagrant Reload Plugin](https://github.com/aidanns/vagrant-reload#installation)
Update build scripts and README to indicate VirtualBox 5.1.6 is required and 5.1.8 does not work due to https://github.com/rapid7/metasploitable3/issues/41
2016-11-10 22:43:19 +01:00
* [VirtualBox 5.1.6](https://www.virtualbox.org/wiki/Downloads)
Update Vagrantfile to remove base file's tutorial comments. Update README.md Add LICENSE and COPYING files
2016-09-07 20:57:55 +02:00
* Internet connection
Update build scripts and README to indicate VirtualBox 5.1.6 is required and 5.1.8 does not work due to https://github.com/rapid7/metasploitable3/issues/41
2016-11-10 22:43:19 +01:00
NOTE: A bug was recently discovered in VirtualBox 5.1.8 that is breaking provisioning. More information [here](https://github.com/rapid7/metasploitable3/issues/41).
Update README.md to add instructions on building using the scripts.
2016-09-27 22:53:08 +02:00
To build automatically:
Fix syntax error in README
2016-09-27 22:56:31 +02:00
Update README.md to add instructions on building using the scripts.
2016-09-27 22:53:08 +02:00
1. Run the build_win2008.sh script if using bash, or build_win2008.ps1 if using Windows.
2. If the command completes successfully, run 'vagrant up'.
3. When this process completes, you should be able to open the VM within VirtualBox and login. The default credentials are U: vagrant and P: vagrant.
To build manually:
Update Vagrantfile to remove base file's tutorial comments. Update README.md Add LICENSE and COPYING files
2016-09-07 20:57:55 +02:00
1. Clone this repo and navigate to the main directory.
2. Build the base VM image by running `packer build windows_2008_r2.json`. This will take a while the first time you run it since it has to download the OS installation ISO.
3. After the base Vagrant box is created you need to add it to your Vagrant environment. This can be done with the command `vagrant box add windows_2008_r2_virtualbox.box --name=metasploitable3`.
Specifically mention the vagrant-reload install in README.md This is for people who skim instead of reading the README the first time around like me. :wink:
2016-10-26 14:18:36 +02:00
4. Use `vagrant plugin install vagrant-reload` to install the reload vagrant provisioner if you haven't already.
5. To start the VM, run the command `vagrant up`. This will start up the VM and run all of the installation and configuration scripts necessary to set everything up. This takes about 10 minutes.
6. Once this process completes, you can open up the VM within VirtualBox and login. The default credentials are U: vagrant and P: vagrant.
Update Vagrantfile to remove base file's tutorial comments. Update README.md Add LICENSE and COPYING files
2016-09-07 20:57:55 +02:00
## Vulnerablities
* [See the wiki page](https://github.com/rapid7/metasploitable3/wiki/Vulnerabilities)
## Acknowledgements
The Windows portion of this project was based off of GitHub user [joefitzgerald's](https://github.com/joefitzgerald) [packer-windows](https://github.com/joefitzgerald/packer-windows) project.
The Packer templates, original Vagrantfile, and installation answer files were used as the base template and built upon for the needs of this project.