Building Nethunter

Building NetHunter

Those of you who want to build a NetHunter image from our GitHub repositories may do so using our Python build scripts.

root@kali:~# git clone https://github.com/offensive-security/kali-nethunter
root@kali:~# cd kali-nethunter/AnyKernel2

The main build script is located in the AnyKernel2 directory, and can be used to build images for multiple devices and Android OS versions, as shown below:

root@kali:~/kali-nethunter/AnyKernel2# python build.py -h
usage: build.py [-h] [--device DEVICE] [--kitkat] [--lollipop] [--marshmallow]
                [--forcedown] [--noaroma] [--uninstaller] [--kernel]

Nethunter zip builder

optional arguments:
  -h, --help            show this help message and exit
  --device DEVICE, -d DEVICE
                        Device names: manta flounder flo grouper shamu
                        hammerhead mako oneplus2cm oneplus2 oneplus1
  --kitkat, -kk         Android.4.4.4
  --lollipop, -l        Android 5
  --marshmallow, -m     Android 6
  --forcedown, -f       Force redownloading
  --noaroma, -n         Use a generic updater-script instead of Aroma
  --uninstaller, -u     Create an uninstaller
  --kernel, -k          Build kernel only
root@kali:~/kali-nethunter/AnyKernel2# 

To build a Lollipop image for a OnePlus One device:

root@kali:~/kali-nethunter/AnyKernel2# python build.py -d oneplus1 --lollipop

The resulting zip file image will be created in the AnyKernel2 directory – this is the zip file you will need to flash on your device later on.

Unlocking, flashing and rooting your Android device (Windows)

For first time installations, it is usually best to completely flash your device "to stock" and bring it to a known good state. This will ensure a painless installation as possible, removing many of the variables that would cause an incomplete or failed installation. While there are many of ways to unlock and root your Android devices, we chose to use the Windows based "Boot Rootkit" by WugFresh. Depending on which type of device you’re setting up, choose the correct Boot Rootkit installer:

• Nexus devices - Nexus Boot Rootkit - http://www.wugfresh.com/nrt/
• OnePlus devices - Bacon Boot Rootkit - http://www.wugfresh.com/brt/

As our preferred device is a OnePlus One phone, we will be demonstrating the installation process using the BRT Windows program.

Installation Caveats

The initial installation of NetHunter can be a frustrating experience if the installation requirements are not met. Most of the installation issues arise from misconfigured Android drivers on your Windows system. It is therefore extremely important to make sure the Android drivers are installed properly before proceeding with the installation. Fortunately, the NRT and BRT applications help us with this process.

Putting your device in "Developer Mode"

Before the installation begins you must enable "Developer mode" on your device. This is done by navigating to Settings -> About and tapping on the "Build number" field 7 times until you receive the notification that developer mode has been enabled.

Go back to the main Settings page and you will have a new section titled "Developer options". Tap on the new "Developer options" field and enable both the "Advanced Reboot" and "Android Debugging" options.

Installing BRT/ NRT and Google / Android Windows drivers

Download and install the NRT/BRT application (as needed) and execute it for the first time. Once loaded, click the "Full Driver Installation Guide" button. A Windows with installation instructions will pop up – it is vital you read these instructions very carefully and follow them slowly. Once you have successfully completed a "Full Driver Test" on Step 4, proceed on with the installation process described below.

Flashing back to Stock

PLACEHOLDER Depending on the version of BRT you are using, you may need to manually apply "Over The Air" updates to your device before proceeding. This is done by navigating to Settings -> About and tapping on the "System updates" field. You may need to apply several updates before the device will be at the latest version, rebooting between each. Once there are no more updates, continue with the installation process described below.

Rooting your Device

PLACEHOLDER

Installing the NetHunter Image

PLACEHOLDER

Post installation setup

PLACEHOLDER

Porting to New Device Guide:

1. Getting Started
2. Modifying a Kernel
3. Building a device script

Working Hardware:

1. Wireless Cards
2. SDR - RTL-SDR
3. Bluetooth

NetHunter App:

1. The NetHunter App can be found here

2. For information and guides, visit the Nethunter app wiki