p41275903
/
monkey
forked from p15670423/monkey
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
monkey/docs/content/setup/linux.md

2.8 KiB
Raw Blame History

title date draft pre weight tags
Linux 2020-05-26T20:57:28+03:00 false <i class="fab fa-linux"></i> 4
setup
AppImage
linux

Supported operating systems

The Infection Monkey AppImage package is supported on the following operating systems (not an exhaustive list):

  • Debian
  • Kali
  • Ubuntu 18.04

Deployment

  1. Make the AppImage package executable: 
    chmod u+x Infection_Monkey_v1.11.0.AppImage
  2. Start Monkey Island by running the Infection Monkey AppImage package: 
    ./Infection_Monkey_v1.11.0.AppImage
  3. Access the Monkey Island web UI by pointing your browser at https://localhost:5000.

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. Run the Infection Monkey AppImage package with the --setup-only flag to populate the $HOME/.monkey_island directory with a default server_config.json file.

    ./Infection_Monkey_v1.11.0.AppImage --setup-only

  2. (Optional but recommended) Move your .crt and .key files to $HOME/.monkey_island.

  3. Make sure that your .crt and .key files are readable only by you.

    chmod 600 <PATH_TO_KEY_FILE>
chmod 600 <PATH_TO_CRT_FILE>

  4. Edit $HOME/.monkey_island/server_config.json to configure Monkey Island to use your certificate. Your config should look something like this:

    {
  "data_dir": "~/.monkey_island",
  "log_level": "DEBUG",
  "environment": {
    "server_config": "password",
    "deployment": "linux"
  },
  "mongodb": {
    "start_mongodb": true
 },
  "ssl_certificate": {
    "ssl_certificate_file": "<PATH_TO_CRT_FILE>",
    "ssl_certificate_key_file": "<PATH_TO_KEY_FILE>"
  }
}

  5. Start Monkey Island by running the Infection Monkey AppImage package:

    ./Infection_Monkey_v1.11.0.AppImage

  6. Access the Monkey Island web UI by pointing your browser at https://localhost:5000.

Upgrading

Currently, there's no "upgrade-in-place" option when a new version is released. To get an updated version, download the updated AppImage package and follow the deployment instructions again.

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