Recon Pi

ReconPi Github

This weekend I wanted to pick up one of my side projects and in this post I will explain the development process. ReconPi is one of those side projects. The recon.sh script is not very extensive yet, so feel free to make PR’s at https://github.com/x1mdev/ReconPi

Update: The repo has received quite some nice contributions already!

Requirements

Starting from the bottom


__________                          __________.__ 
\______   \ ____   ____  ____   ____\______   \__|
 |       _// __ \_/ ___\/  _ \ /    \|     ___/  |
 |    |   \  ___/\  \__(  <_> )   |  \    |   |  |
 |____|_  /\___  >\___  >____/|___|  /____|   |__|
        \/     \/     \/           \/             
                        v0.1.1 - by @x1m_martijn

Initial setup

Download the initial image from wiki.ubuntu.com or you can grab this direct download link.

After downloading the latest .img.xz file we need to “flash” this image to the SD card. I would recommend using Etcher to do this, I never had any issue with flashing an image so far and it’s super easy.

Select the downloaded image and insert your SD card or USB storage device. Etcher will automatically detect the card and you can simply continue by clicking on “Flash!”.

etcher app

The easiest way is to use the SD card method because it works straight out of the box. To use the USB mass storage device method check this link.

Attach all the cables to the Raspberry Pi, you can choose to use the SSH method or use a keyboard and monitor. I will be using the SSH method but all of the commands can be used with a monitor and keyboard as well.

Preparing the system

All the physical preparation are done now, time to prepare the system itself!

Find the ip address of the Recon Pi:


# run ifconfig to find your own IP address.

nmap -sP 192.168.2.13/24 | grep rpi

I changed the hostname of the Pi to rpi3, so I can grep it easier. It should be ubuntu by default. Alternatively, you can leave out the piping to grep and manually look for the IP address.

nmap rpi

Login to the Pi with SSH:


ssh [email protected][your.ip.address]

Default username and password for this image: ubuntu:ubuntu

To install all the required tools there are 2 simple options:

Option 1:

  • cd ~
  • git clone https://github.com/x1mdev/ReconPi.git
  • cd ReconPi
  • chmod +x install.sh
  • sudo bash install.sh

Option 2:

Download the install.sh script:


wget https://raw.githubusercontent.com/x1mdev/ReconPi/master/install.sh

Give it the right permission:


chmod +x install.sh

Run the install script:


# Don't forget sudo!
sudo bash install.sh

Grab a cup of coffee, this will take a few minutes.

The last step currently asks you if you want to install Aquatone, default is no because I have not implemented it in the recon.sh. It’s also a pretty big Docker image and takes some time to build on the ReconPi. After the final step the output from install.sh is:


[+] Script finished!

Reboot the ReconPi and log in again.

First run

All tools are now configured and ready to go


# (if you are not in the ReconPi directory)
cd ReconPi

Run the script:


bash recon.sh example.com

The script will run all the scans and you can just sit back and relax (again :D).

This is the initial setup and usage for the ReconPi. Please feel free to send in Pull Requests to contribute on https://github.com/x1mdev/ReconPi