2021-04-02 00:25:34 +08:00
|
|
|
# Monkey Island AppImage
|
|
|
|
|
|
|
|
|
|
## About
|
|
|
|
|
|
2021-04-15 18:29:47 +08:00
|
|
|
This directory contains the necessary artifacts for building an Infection
|
|
|
|
|
Monkey AppImage
|
2021-04-02 00:25:34 +08:00
|
|
|
|
|
|
|
|
## Building an AppImage
|
|
|
|
|
|
|
|
|
|
1. Create a clean VM or LXC (not docker!) based on Ubuntu 18.04.
|
|
|
|
|
1. Copy the `deployment_scripts/appimage` directory to `$HOME/` in the VM.
|
|
|
|
|
1. Run `sudo -v`.
|
|
|
|
|
1. On the VM, `cd $HOME/appimage`
|
|
|
|
|
1. 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)
|
2021-04-29 23:50:22 +08:00
|
|
|
- $HOME/appimage/squashfs-root
|
2021-04-02 00:25:34 +08:00
|
|
|
- $HOME/git/monkey
|
2021-04-30 01:22:04 +08:00
|
|
|
- $HOME/appimage/Infection_Monkey*x86_64.AppImage
|
2021-04-02 00:25:34 +08:00
|
|
|
|
|
|
|
|
After removing the above files and directories, you can again execute `bash
|
|
|
|
|
build_appimage.sh`.
|
|
|
|
|
|
|
|
|
|
## Running the AppImage
|
|
|
|
|
|
2021-04-15 18:29:47 +08:00
|
|
|
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.
|
2021-04-02 00:25:34 +08:00
|
|
|
|
|
|
|
|
A new directory, `$HOME/.monkey_island` will be created to store runtime
|
|
|
|
|
artifacts.
|
