Installing NetHunter

Table of Contents

Overview

Installing NetHunter requires the following steps:

  1. Download a pre-built image or build your own image
  2. Put your device in developer mode
  3. Unlock your device
  4. Install TWRP
  5. Flash Magisk
  6. Android 9 and above: Format “data” and flash Universal DM-Verity & ForceEncrypt Disabler
  7. Install NetHunter
  8. Android 10 and above: Update NetHunter App from the NetHunter Store
  9. Run the NetHunter App to finish the installation

 

1. NetHunter support and pre-built images

You can confirm that your device and Android version is supported via our gitlab live reports:

The NetHunter team builds and publishes images for a selected list of devices, on the official NetHunter download page.

If you devices is supported by NetHunter but not available as a pre-build image, you can easily build your own image by following the steps in our “Building NetHunter” documentation

 

2. 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 section and enable both the Advanced Reboot and Android Debugging options.

 

3. - 5. Unlocking, rooting, and installing a custom recovery on your android device

NetHunter supports over 60 different devices running Android versions from Kitkat though to Android Q. Whilst we have standardised the NetHunter installation procedure, the steps to unlock, root, and install a custom recovery varies from device to device and even differs between Android versions. The preferred custom recovery for NetHunter is TWRP. The preferred software to root the device for NetHunter is Magisk. Please refer to the appropriate guide to unlock, root, and install a custom recovery on your device from your preferred internet resource, such as the XDA Developers Forum

 

6. Flashing Universal DM-Verity & ForceEncrypt Disabler

IMPORTANT NOTE for Android 9, 10, & 11 users: Please ensure that you flash the Universal DM-Verity, ForceEncrypt Disabler and format the data partition prior to installing NetHunter. Magisk does not support user context changes on encrypted data partitions, which leads to errors when connecting to the Kali rootfs via ssh (i.e. “Required key not available”) if the data partition is encrypted.

 

7. - 9. Installing the NetHunter Image

Now that your Android phone is ready, transfer the NetHunter image to it, reboot in recovery mode, and flash the zip on your phone. Once done, reboot and launch the NetHunter app to complete the setup!

IMPORTANT NOTE for Android 10 & 11 users: Please update the NetHunter app from the NetHunter store after flashing NetHunter. Android 10 introduced “scoped storage” restrictions which prevents NetHunter from using the storage location we traditionally used to save configuration files. We are in the process of moving the location and implementing an import/export function but updating the app after flashing NetHunter provides a workaround that allows us to continue accessing the current storage location until the new features are implemented.


Updated on: 2024-Mar-01
Author: re4son