monkey/appimage
Mike Salvatore f91a52f0c0 appimage: Exit with error if unsupported parameters are passed 2021-04-30 10:17:53 -04:00
..
.gitignore build: move ./deployment_scripts/appimage -> ./appimage 2021-04-15 11:32:10 -04:00
AppRun appimage: remove unused $executable var from AppRun 2021-04-15 11:32:10 -04:00
README.md appimage: Add cli parameter for specifying the package version 2021-04-30 10:17:53 -04:00
build_appimage.sh appimage: Exit with error if unsupported parameters are passed 2021-04-30 10:17:53 -04:00
clean.sh appimage: Add cli parameter for specifying the package version 2021-04-30 10:17:53 -04:00
infection-monkey.desktop build: move ./deployment_scripts/appimage -> ./appimage 2021-04-15 11:32:10 -04:00
island_logger_config.json build: move ./deployment_scripts/appimage -> ./appimage 2021-04-15 11:32:10 -04:00
run_appimage.sh appimage: remove unnecessary blank lines in run_appimage.sh 2021-04-15 11:32:10 -04:00
server_config.json.standard build: move ./deployment_scripts/appimage -> ./appimage 2021-04-15 11:32:10 -04:00

README.md

Monkey Island AppImage

About

This directory contains the necessary artifacts for building an Infection Monkey AppImage

Building an AppImage

  1. Create a clean VM or LXC (not docker!) based on Ubuntu 18.04.
  2. Copy the deployment_scripts/appimage directory to $HOME/ in the VM.
  3. Run sudo -v.
  4. On the VM, cd $HOME/appimage
  5. Execute ./build_appimage.sh. This will pull all necessary dependencies and build the AppImage.

NOTE: This script is intended to be run from a clean VM. You can also manually remove build artifacts by removing the following files and directories.

  • $HOME/.monkey_island (optional)
  • $HOME/appimage/squashfs-root
  • $HOME/git/monkey
  • $HOME/appimage/Infection_Monkey*x86_64.AppImage

After removing the above files and directories, you can again execute bash build_appimage.sh.

Running the AppImage

The build script will produce an AppImage executible named Infection_Monkey-x86_64.AppImage. Simply execute this file and you're off to the races.

A new directory, $HOME/.monkey_island will be created to store runtime artifacts.