This repo provides an easy way to deploy a clean and customized pentesting environment with Kali linux using vagrant and virtualbox.

I assume you are familiar with virtualbox and vagrant.

• https://www.virtualbox.org/
• http://www.vagrantup.com/

Latest pentest-env release is tested with:

• Virtualbox (5.1.28)
• Vagrant (1.8.5)

See the documentation page about boxes for more details.

To get started with pentest-env, clone this repository and run vagrant up inside the directory. This will download and run the Kali instance.

You can customize, add targets, create new targets etc.. inside pentest-env. Some examples are available in the examples/ directory, to use one simply set the PENTESTRC environment variable:

> PENTESTRC=examples/ctf.pentestrc vagrant status
Current machine states:

kali                      running (virtualbox)
metasploitable2           not created (virtualbox)
primer                    not created (virtualbox)

This environment represents multiple VMs. The VMs are all listed
above with their current state. For more information about a specific
VM, run `vagrant status NAME`.

For more details, visit the documentation pages:

1. Installation
2. Usage
3. Docker
4. Openstack
5. Customizations
6. Instances
7. Targets
8. Write custom instances and targets
9. Debugging
10. Security
11. About boxes
12. Known issues

Some configuration examples:

1. Configure Kali linux with Tor & proxychains
2. Configure Kali linux with Whonix gateway
3. Faraday cscan against metasploitable 2 & 3 targets
4. Configure a Teamserver

It's recommended to check downloaded box files with provided checksums (SHA256).
See https://raw.githubusercontent.com/Sliim/pentest-env/master/checksums.txt for checksums list.

Provided boxes run the sshd service.
So if you plan to run the Kali linux with a Bridged interface, default setup can be dangerous!

• root password of kali is toor.
• SSH private key is not private! Anyone can use this key to connect to your instance.

See the secure the environment page to automatically change these defaults values.

See COPYING file