Get involved


Getting Started for Google Cloud users

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




Deploying an image

Select Infection Monkey from the Google Cloud Launcher console and click LAUNCH ON COMPUTE ENGINE.


  1. Choose a name for your Infection Monkey instance, e.g. InfectionMonkey.
  2. Choose a machine type or stick with the recommended machine.
  3. Make sure “Allow TCP port 5000 traffic” is checked.
  4. Click Deploy.

At this point, Google Cloud will instance and deploy your new machine.


When ready, you can browse to the Infection Monkey running on your fresh deployment at


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.