Infection Monkey Linux Package Builder

About

This directory contains the necessary artifacts for building an Infection Monkey packages for Linux.

AppImage

Building an AppImage

1. Create a clean VM or LXD (not docker!) based on Ubuntu 18.04.
2. Copy the build_scipts/ directory to $HOME/ in the VM.
3. On the VM, cd $HOME/build_scripts
4. Run sudo -v.
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 running appimage/clean.sh

WARNING: If you use a LXD container, ensure that shiftfs is disabled.

Running the AppImage

The build script will produce an AppImage executable named ./dist/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.

Docker

Building a Docker image

1. Create a clean Ubuntu 18.04 VM (not WSL).
2. Copy the build_scipts/ directory to $HOME/ in the VM.
3. On the VM, cd $HOME/build_scripts
4. Run sudo -v.
5. Execute ./build_docker.sh --package docker. This will pull all necessary dependencies and build the Docker image.

NOTE: This script is intended to be run from a clean VM. You can also manually remove build artifacts by running docker/clean.sh

Running the Docker Image

The build script will produce a .tgz file in ./dist/. To load the .tgz file:

1. Extract the Monkey Island Docker tarball:

   tar -xvzf InfectionMonkey-docker-v2.0.0.tgz

2. Load the Monkey Island Docker image:

   sudo docker load -i InfectionMonkey-docker-v2.0.0.tar

For more information on how to run your local Monkey Island Docker image, see https://techdocs.akamai.com/infection-monkey/docs/docker/.