Get involved


Getting Started

Getting started consists of two easy steps - deploying a new image and launching the Infection Monkey!




Deploying an image

To deploy the container, once you've extracted it from the tar.gz file, run the following commands:


  • sudo docker load -i dk.monkeyisland.latest.tar
  • docker pull mongo
  • sudo mkdir -p /var/monkey-mongo/data/db
  • sudo docker run --name monkey-mongo --network=host -v /var/monkey-mongo/data/db:/data/db -d mongo
  • sudo docker run --name monkey-island --network=host -d guardicore/monkey-island:1.6.3

Using the Infection Monkey

After deploying the Monkey Island in your environment, navigate to https://<server-ip>:5000. To get the Infection Monkey running as fast as possible, click Run Monkey. Optionally, you can configure the Monkey before you continue by clicking Configuration (see Appendix A).


To run the monkey, select one of the following options:

1. Click Run on C&C Server to run the Infection Monkey on the Monkey Island server. This simulates an attacker trying to propagate from a machine in the Monkey Island subnet.


2. Click Run on machine of your choice to download and execute the Infection Monkey on a machine of your choice. Then follow the instructions and execute the generated command on the machine of your choice. This simulates an attacker who has breached one of your servers. The Monkey will map all accessible machines and their open services and try to steal credentials and use its exploits to propagate.

Next, click the Infection Map link to see the Infection Monkey in action.

At first, the infection map will look like this:

Within a few minutes, the Infection Monkey should be able to find and attack accessible machines.

As the Infection Monkey continues, the map should be filled with accessible and “hacked” machines. Once all the Infection Monkeys have finished propagating, click Security Report (see Appendix B).

Congratulations, you finished first successful execution of the Infection Monkey! To thoroughly test your network, you can run the Infection Monkey from different starting locations using different configurations (see Appendix A).


If you have any questions, contact us or post to the Infection Monkey Google Group.


Appendix A: Configuration

The Monkey is very configurable, nearly every part of it can be modified to turn it to a fast acting worm or into a port scanning and system information collecting machine.


The configuration is split into two parts, Basic and everything else, the Basic options are pretty self explanatory and are split into two sections:


1. Credentials:
In this screen you can feed the Monkey with “stolen” credentials for your network, simulating an attacker with inside knowledge.


2. Network:
Here you can control multiple important settings, such as:

  • Network propagation depth - How many hops from the base machine will the Monkey spread
  • Local network scan - Should the Monkey attempt to attack any machine in its subnet
  • Scanner IP/subnet list - Specific IP ranges that the Monkey should try to attack.

Appendix B: Security Report

The report is split into 3 categories


  • Overview
  • Recommendations
  • The Network from the Monkey’s Eyes. You can also download a printable version of the report by clicking the Print Report option.