The Pineapple NANO and TETRA are excellent security hardware but in 2020 they reached their end of life.
So to give a new life to this platform on modern hardware I developed these scripts to port it to different routers.
Sometime between 2019 and 2020 we started using the private beta of this project which my friends called "Pineapple Termidor".
So at the time of redoing this project I decided to rescue the original name from forgotten 🤣
This project is the result of everything I've experienced from 2018 to 2022 to successfully port the NANO and TETRA in any hardware.
For this I've develop:
- The method of patching the file system with the minimum to be able to work. For this I created the list of files to copy and the script that copies them.
- A script to patch the file system to work on any hardware.
- Completely updated panel with fixes and improvements.
- Completely updated packages repository (build).
- New module repository.
- And some new modules that are basic to use a device like this nowadays. New modules: PMKIDAttack and Terminal
- I also carefully checked every dependency that was installed on the device in order to have more free space on the main partition.
You can find the complete steps to build this project in this document. I have also added several important notes that will help you to try porting to other devices.
If you are interested in developing tools of this type, you may find my new development interesting Frieren
This project supports over 200 confirmed devices capable of running the firmware without issues.
You can check the complete supported devices list for detailed compatibility information.
If your router is not officially supported, private test builds are available on Patreon for experimental use.
Additionally, the build repository contains precompiled firmware images for the most common supported models.
If your device isn’t listed or you prefer a newer, actively developed alternative, check out my other project Frieren.
Most firmware images found on the internet are created using Patrick Sapinski’s method, which duplicates the entire original filesystem.
While it works, this approach wastes space and frequently causes instability — that’s why I developed a new, optimized technique.
I first presented this improved method at EkoParty 2020 and DragonJar 2021 during my hardware porting talks.
You can find the materials from those presentations here.
In 2021, an idiot named Samy Younsi shamelessly plagiarized my work, copying the method I had developed and showcased at conferences.
A few months later, he rewrote it in Python based on Wifi Pineapple Cloner v1 and started distributing it as his own.
During 2022, I refined and fully debugged the process, making it possible to port the Pineapple firmware to almost any hardware with results identical to the original device.
This final iteration achieves:
- Much smaller firmware size
- Higher stability and reliability
- Performance indistinguishable from official hardware
-
Install OpenWrt version 19.07.7 on your router.
You can find official firmware images at https://firmware-selector.openwrt.org/.
Note that some routers may not appear there — in those cases, you will need to manually locate the correct firmware link for your device.
Remember, not all routers are supported by this OpenWrt version. -
Open the OpenWrt 19.07.7 LuCI web interface (default:
http://192.168.1.1).
Navigate to System → Backup / Flash Firmware → Flash new firmware image. -
Download the correct firmware for your router model from the official build repository.
Upload that file (e.g.gl-ar750s-universal-sysupgrade.bin) in the LuCI panel, and check the option “Do not keep settings” to ensure a clean installation.
You must install it with the do not save configuration over reflash option checked. -
Click Flash Image, confirm, and wait patiently until the flashing process and automatic reboot are fully completed.
-
Enter to pineapple panel and enjoy!
http://172.16.42.1:1471/In the download repo you can find some debugging tips if you have problems. -
Once installed, the project has a tool that helps us to do several things. For example you can use it to change the panel theme with this command:
wpc-tools theme_install
-
USB 2.0 2 ports hub
-
USB Pendrive or a SD Card (depending on what your router best supports)
-
Generic RT5370 WIFI adapter or MT7612U WIFI adapter you're really going to need this on hardware that doesn't have two wifi adapters
-
Please support Hak5 work and buy the new hardware!
Those who want to help buy testing hardware or just give me a tip, you can do it by sending donations to my Binance account. I also made a Patreon account where I share private builds and tests. Here you can find updates for the Pineapple Nano and builds to improve stability on 5g.