Windows
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:
- Follow the steps to complete the installation.
- 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.
- Stop the Monkey Island process.
- (Optional but recommended) Move your
.crt
and.key
files to%AppData%\monkey_island
. - Modify the
server_config.json
(by default located inC:\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" }, ... }
- Run the Monkey Island by clicking on the desktop shortcut.
- Access the Monkey Island web UI by pointing your browser at
https://localhost:5000
.
Change logging level
- Stop the Island Server.
- Modify the
server_config.json
(by default located inC:\Program Files\Infection Monkey\monkey_island\cc\server_config.json
) by adding the following lines:{ ... "log_level": "INFO", ... }
- Run the Monkey Island by clicking on the desktop shortcut.
- 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.
Updated over 1 year ago