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

2.2 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

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 read-only and readable only by you.

    chmod 400 <PATH_TO_KEY_FILE>
chmod 400 <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