Deployment

📘

Infection Monkey flagged as malware

Don't worry if the Infection Monkey gets flagged as malware during the installation.

After running the installer, the following prompt should appear on the screen:

  1. Follow the steps to complete the installation.
  2. Run the Infection Monkey by clicking on the desktop shortcut.

Notes:

  • If you want Agents to collect more data on the current machine, consider running as Administrator.
  • If you're prompted to delete your data directory and are unsure what to do, see the FAQ for more information.

Once you have access to the Monkey Island server, check out the getting started page

Configuring the server

You can configure the server by editing the configuration file located in the installation directory.
The default path is
`C:\Program Files\Infection Monkey\monkey_island\cc\server_config.json

Start Monkey Island with a user-provided certificate

By default, Infection Monkey comes with a self-signed SSL certificate. In an enterprise or other security-sensitive environments, we recommend that the user provides Infection Monkey with a certificate that a private certificate authority has signed.

  1. Stop the Monkey Island process.
  2. (Optional but recommended) Move your .crt and .key files to %AppData%\monkey_island.
  3. Modify the server_config.json (by default located in C:\Program Files\Infection Monkey\monkey_island\cc\server_config.json) by adding the following lines:
    {
      ...
      "ssl_certificate": {
            "ssl_certificate_file": "%AppData%\\monkey_island\\my_cert.crt",
            "ssl_certificate_key_file": "%AppData%\\monkey_island\\my_key.key"
      },
      ...
    }
    
  4. Run the Monkey Island by clicking on the desktop shortcut.
  5. Access the Monkey Island web UI by pointing your browser at https://localhost:5000.

Change logging level

  1. Stop the Island Server.
  2. Modify the server_config.json (by default located in C:\Program Files\Infection Monkey\monkey_island\cc\server_config.json) by adding the following lines:
    {
        ...
        "log_level": "INFO",
        ...
    }
    
  3. Run the Monkey Island by clicking on the desktop shortcut.
  4. Access the Monkey Island web UI by pointing your browser at https://localhost:5000.

Troubleshooting

Support

Only English system locale is supported. If your command prompt gives output in a different language, the Infection Monkey is not guaranteed to work.

For supported Windows versions, take a look at the OS support page.

Missing Windows Update

The installer requires Windows update #2999226. If you're having trouble running the installer, please make sure to install the update via Windows Update or manually from the link above.

Supported browsers

The Monkey Island supports Chrome (and Chrome-based) browsers. If your Windows server only has Internet Explorer installed, please install Chrome or a similar modern browser. You can download Google Chrome here.

Upgrading

To upgrade the Infection Monkey on Windows, download the new installer and run it. The new Monkey version will be installed over the old version.

If you'd like to keep your existing configuration, you can export it to a file using the Export config button and then import it to the new Monkey Island.