monkey/appimage/README.md

1.1 KiB

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