History

Mike Salvatore 98c9b2a907 appimage: Use pipenv to install python dependencies		2021-04-22 09:50:30 -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	build: Update appimage README since we switched from appimage-builder	2021-04-15 11:32:10 -04:00
build_appimage.sh	appimage: Use pipenv to install python dependencies	2021-04-22 09:50:30 -04:00
clean.sh	appimage: Add clean.sh script	2021-04-22 09:50:29 -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

Create a clean VM or LXC (not docker!) based on Ubuntu 18.04.
Copy the deployment_scripts/appimage directory to $HOME/ in the VM.
Run sudo -v.
On the VM, cd $HOME/appimage
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.