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
  10. Install via Magisk

1. NetHunter pre-built images and support

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

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

You can confirm that your device and Android version is supported via:

You can check out the weekly or daily images if there was an update after release:

If your device is not supported, you can still use NetHunter Lite on any rooted device with limited hardware features.

You can find more architectures (armhf, i386, amd64) here

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. Unlocking, rooting, and installing a custom recovery on your android device

NetHunter supports over 99 different devices running Android versions from 4.4/Kitkat though to 15/Fifteen.

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 Forums.

4. 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.

5. 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.

6. The new way of installing NetHunter as Magisk module

IMPORTANT NOTE for devices without disabled force encryption:

  • Use the same NetHunter installer zip file to install as a module in Magisk.
  • Recommended version: Magisk v27000 or older.
  • Keep the screen awake while installing, Android may kill the app with locked screen.
  • Reboot.

Updated on: 2024-Nov-20
Authors: re4son , yesimxev