Portable Penetration Testing Kit

This project is a Raspberry Pi-based penetration testing toolkit designed for personal use. It provides a collection of pre-installed tools such as Metasploit, Wireshark, Nmap, and more, aimed at performing network and security assessments from your Raspberry Pi. The setup is simple and does not require a monitor; everything can be controlled via SSH. Additionally, a Flask dashboard provides an easy-to-use web interface to manage and monitor the toolkit.

Features

• Pre-installed penetration testing tools:
  • Metasploit for exploitation
  • Wireshark for packet analysis
  • Nmap for network scanning
• A Flask-based dashboard to monitor system metrics and interact with the tools.
• Easy-to-follow installation script for setting up all tools and dependencies.
• SSH-based operation (no need for a monitor).
• Fully customizable setup process.

Requirements

• Raspberry Pi (any model supported by Kali Linux)
• Kali Linux (or any Linux distro with similar tools)
• Internet connection for downloading tools and dependencies

Setup Instructions

1. Flash the SD Card

1. Download and install Raspberry Pi Imager
2. Use Raspberry Pi Imager to flash the image of any linux os onto the SD card. During the flashing process, enable SSH by setting the SSH option in the settings.
3. Configure your Wi-Fi settings, username, password, and hostname through the Raspberry Pi Imager before flashing.

2. Clone the Repository

Once your Raspberry Pi is set up, SSH into it using its IP address. For SSH, use:

• On Linux/macOS:

  ssh pi@<IP_ADDRESS>

• On Windows (using PowerShell):

  ssh pi@<IP_ADDRESS>

Replace <IP_ADDRESS> with the actual IP of your Raspberry Pi. You can find it by checking your router or using a network scanner.

After SSH-ing into the Raspberry Pi, run the following commands:

git clone https://github.com/DevaanshPathak/rpi-pentest-kit.git
cd rpi-pentest-kit

3. Run the Setup Script

Run the following command to make the setup.sh script executable:

chmod +x setup.sh

Then execute the script to install all the required tools and dependencies:

./setup.sh

This will automatically install Metasploit, Wireshark, Nmap, and other essential tools.

4. Access the Flask Dashboard

Once the setup is complete, open a browser and navigate to your Raspberry Pi’s IP address:

http://<IP_ADDRESS>:80

This will show the Flask dashboard where you can monitor system metrics and interact with the installed tools.

5. Accessing the Console Feature

The web interface allows you to execute commands via a console. To use it:

1. Log in with the pi username and password.
2. Run shell commands directly from the browser console.

Additional Notes

• Ensure that your Raspberry Pi is connected to the network (either via Ethernet or Wi-Fi) to allow SSH access.
• You can use nmap and metasploit directly from the Flask interface, or via SSH if you prefer command-line operations.
• This setup is for personal use and should not be used for unauthorized activities.

License

This project is licensed under the MIT License - see the LICENSE file for details.