snowsecurity/recon-ng repository overview

⁠Using Docker

1. Install Docker
2. Ensure the ~/.recon-ng directory exists on the host.
3. Clone the Recon-ng repository.
   • git clone https://github.com/lanmaster53/recon-ng.git
4. Change into the Recon-ng directory.
   • cd recon-ng
5. Build the Docker image.
   • docker build -t recon-ng .
6. Run Recon-ng.
   • docker run --rm -it -p 5000:5000 -v $(pwd):/recon-ng -v ~/.recon-ng:/root/.recon-ng --entrypoint "./recon-ng" snowsecurity/recon-ng:v5
     • -rm removes the container when it exits.
     • -it makes the container interactive.
     • -p binds a local and container port.
     • -v mounts a couple necessary volumes (the source code and the recon-ng home folder).
     • --entrypoint indicates the command to run. Change this to run other things like recon-cli, /bin/sh, etc.
     • recon-ng the image to use.

The above command supports everything in Recon-ng except running tasks via the web API. All other API calls will work, but attempting to run a task requires Redis, which is not included in the Recon-ng Docker image. Use Docker Compose to launch all of the required containers (Recon-ng, Redis, and worker) for the full Recon-API experience.

• docker-compose up -d --build

When done using Recon-API, clean up the Docker environment with the following command:

• docker-compose down

To debug within one of the Docker Compose services (Recon-web example):

• docker-compose run -p 5000:5000 <service_name> python3 -m pdb recon-web

To troubleshoot within one of the Docker Compose services:

• docker-compose run <service_name> /bin/sh

⁠Help

Recon-ng has an official Slack workspace. For additional help, information, or general discussion about the framework, join by completing the self-registration form at https://goo.gl/forms/IJrxxWpglWu0Eyzl2⁠.