just-go-phishing

Phishing infrastructure deployment made easy.

License: GNU Affero General Public License v3.0 or later

Overview

just-go-phishing is a Python tool to simplify the setup of phishing infrastructure using Docker containers.

Instructions

Install Docker for your operating system. Install dependencies with the following commands:

$ python3 -m venv .venv
$ source .venv/bin/activate
$ pip install -r requirements.txt

Update the domain and email fields under both lego and gophish keys with the new values in the run section of config.json.

"run": {
    "lego": {
        ...
        "domain": "newdomain.com",
        "email": "newemail@domain.com"
    },
    "gophish": {
        ...
        "domain": "newdomain.com",
        "email": "newemail@domain.com"
    }
}

Replace newdomain.com and newemail@domain.com with the domain and email address to be used for the phishing campaign.

Run using the configuration specified in config.json:

$ python main.py build --complete
$ python main.py run --complete

just-go-phishing has been tested exclusively on Linux.

Commands

Clean

• --containers: Remove all Docker containers
• --images, --force: Delete unused or all Docker images
• --cache: Clear Docker build cache
• --volumes: Clean specified local directories
• --complete, --force: Full cleanup of Docker environment and local volumes

Build

• --image: Build "lego" or "gophish" images individually
• --complete: Build "lego" and "gophish" images simultaneously

Run

• --container: Deploy "lego" or "gophish" containers individually
• --complete: Deploy both "lego" and "gophish" containers simultaneously