p15670423
/
monkey
1
0
Fork 5
Code Issues Pull Requests 3 Projects Releases Wiki Activity
monkey/docs/content/setup/windows.md

3.1 KiB
Raw Blame History

title date draft pre weight tags
Windows 2020-05-26T20:57:10+03:00 false <i class="fab fa-windows"></i> 2
setup
windows

Deployment

{{% notice tip %}} Don't get scared if the Infection Monkey gets flagged as malware during the installation. {{% /notice %}}

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

Windows installer screenshot

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

{{% notice info %}} If you're prompted to delete your data directory and you're not sure what to do, see the [FAQ]({{< ref "/faq/#i-updated-to-a-new-version-of-the-infection-monkey-and-im-being-asked-to-delete-my-existing-data-directory-why"

}}) for more information. {{% /notice %}}

Start Monkey Island with user-provided certificate

By default, Infection Monkey comes with a self-signed SSL certificate. In enterprise or other security-sensitive environments, it is recommended that the user provide Infection Monkey with a certificate that has been signed by a private certificate authority.

  1. If you haven't already, run the Monkey Island by clicking on the desktop shortcut. This will populate MongoDB, as well as create and populate %AppData%\monkey_island.

  2. Stop the Monkey Island process.

  3. (Optional but recommended) Move your .crt and .key files to %AppData%\monkey_island.

  4. Create a server configuration file and provide the path to the certificate.

  5. Run the Monkey Island by clicking on the desktop shortcut.

  6. 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.

Export configuration