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!
- Raspberry Pi 3 + cables (Power and Ethernet)
- Keyboard + monitor (optional)
- SD card, 8 GB minimum
- Ubuntu 16.04 armfh raspi3
Starting from the bottom
__________ __________.__ \______ \ ____ ____ ____ ____\______ \__| | _// __ \_/ ___\/ _ \ / \| ___/ | | | \ ___/\ \__( <_> ) | \ | | | |____|_ /\___ >\___ >____/|___| /____| |__| \/ \/ \/ \/ v0.1.1 - by @x1m_martijn
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!”.
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.
Login to the Pi with SSH:
ssh [email protected][your.ip.address]
Default username and password for this image:
To install all the required tools there are 2 simple options:
git clone https://github.com/x1mdev/ReconPi.git
chmod +x install.sh
sudo bash 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
[+] Script finished!
Reboot the ReconPi and log in again.
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