First steps
In this tutorial, we will set up a simple sandbox environment that will be
useful in future tutorials. We will learn how to access the Infection Monkey's
command and control server and register a new user.
Prerequisites
First, make sure that you have the following installed:
docker
anddocker-compose
Run the environment
Next, we'll use docker compose
to run Infection Monkey along with our
vulnerable container.
- Download the docker-compose.yaml file.
- Then, navigate to the directory where you downloaded the file and run the following command to start the environment:
docker compose up
Now you should have 3 containers running:
monkey-island
- the Infection Monkey servermongo
- database used by Infection Monkeyhello
- a vulnerable container
You can confirm this by running
$ docker container ls --format "table {{.ID}}\t{{.Names}}\t{{.Status}}"
CONTAINER ID NAMES STATUS
737b67cc344c monkey-island Up 7 seconds
fbd91aacc8ea mongo Up 7 seconds
b1c9ac1d3b81 hello Up 7 seconds
Now that the environment is running, open a browser to https://localhost:5000 to access the Monkey Island web interface. You may see a warning that looks similar to the one shown below.
For this tutorial, you can safely ignore this warning by clicking Advanced followed by Proceed to localhost (unsafe).
Since this is the first time you're accessing this Infection Monkey instance, you'll need to register. Provide a username and password, and then click Let's go!.
After registering, you'll be automatically logged in and taken to the Getting Started page.
๐ Congratulations ๐ Your environment is up and running!
Review
Let's take a moment to review what you've learned:
- You now know how to create a sandbox environment to experiment with Infection Monkey using Docker.
- You've learned how to register a user with Infection Monkey.
Next steps
Now that you have a sandbox environment for experimenting with Infection Monkey, you can move on to Tutorial 1: Hello, Monkey, where you'll learn how to configure and use Infection Monkey to exploit a vulnerable server.
If you'd like to install Infection Monkey on a different platform, you can find instructions on the Setup page.
Updated 4 months ago