Installation of GearUP Router Plugin on Keenetic/Netcraze Routers (Beta Version)

Note: This guide is in beta. Changing router settings involves risks, so please follow the steps carefully. If you encounter any problems, submit feedback in the GearUP Router app or join our discussion group: https://t.me/+7LUdmSMlj_c5ZGJl

Plugin Installation Methods Supported by Each Model

• Below are the plugin installation methods for some of the main models. For memory installation, it is recommended to update the router firmware to KeeneticOS 3.7 or above.
• If your router model is not on this list, please visit the official website to check whether your model supports plugin installation.

Before You Begin

1. Confirm that your router model and firmware version are supported.
2. Confirm whether your router supports Entware in internal storage or requires a USB drive.
3. Open the GearUP Router App and confirm that your console and target game are available.
4. Use a computer or phone connected to the router's main LAN/Wi-Fi network. Do not use a guest or isolated Wi-Fi network.

Preparations: Confirm Your Router's Gateway IP

During the plugin installation, there are two places that require your router's gateway IP. Please confirm it by following these steps:

1. Press Win + R on your keyboard to open the Run dialog.
2. Type cmd and press Enter.
3. In the Command Prompt window, type ipconfig and press Enter.
4. Find the network adapter currently in use (Wi-Fi or Ethernet) and look for Default Gateway.
5. The IP address shown next to Default Gateway is your router gateway IP. For example: Default Gateway . . . . . . . . . : 192.168.1.1, the 192.168.1.1 is the router gateway IP.
6. Replace [router gateway ip] in the SSH command with the gateway IP you found.
   

Step 1: Install "Kernel modules for filesystems support" and "Kernel modules for Netfilter".

1. Connect your PC to the router, open a web browser (Google Chrome, Safari, Opera, Mozilla Firefox, or Microsoft Edge), and enter [Your router gateway IP]* in the address bar to access the router’s web management interface.
   
2. Enter your router's username and password to log in.
   
3. Navigate to: General system settings → KeeneticOS update and component options.
   
   
4. Click Component options.
   
5. In the OPKG packages list, check Open Package support, Kernel modules for filesystems support, and Kernel modules for Netfilter, then click Update KeeneticOS.
   
6. In the pop-up window, click Back up now to back up your data.
   
7. When the system prompts to install the update, click Confirm.
   

Step 2: Install Entware (Internal Storage or USB Drive)

'Open Package support' is a Keenetic/Netcraze system component. Entware is a third-party package environment installed through OPKG and is required for the GearUP Router Plugin.

Internal-storage installation is available only on supported router models. If the Internal storage option is not available in OPKG Package Manager, follow the USB installation instructions instead.

You can follow the official tutorial to complete the installation: https://support.keenetic.com/hero/kn-1012/en/18482-installing-opkg-entware-in-the-router-s-internal-memory.html.

If an issue occurs, you can cancel the installation as shown in the images below and then try again.

Select and Save the Entware Storage

1. Open OPKG Package Manager.
2. In the Drive field, select Internal storage.
3. Enable Access for the administrator account that will use OPKG services.
4. Click Save.

Do not continue until the storage selection has been saved successfully.

Open cmd, type ssh [email protected] and press Enter

192.168.1.1 is the router gateway IP. Then enter the router WebUI password and press Enter.

Type exec sh

1. Press Enter
   
2. After pressing Enter it will look like this.
   

Preferred Method — Online Entware Installation

In the Keenetic CLI, run the exact installation command listed for your router model and architecture. Example for a supported aarch64 model:

opkg disk storage:/ https://bin.entware.net/aarch64-k3.10/installer/aarch64-installer.tar.gz

Wait for the installation to complete and check the System log. Use the manual download/upload method only if online installation fails.

Alternative Method — Manual Download/Upload

Run: uname -m, press Enter, see what it displays, then download the corresponding installer package.

• Main site: https://bin.entware.net
• aarch64 installer package: https://bin.entware.net/aarch64-k3.10/installer/aarch64-installer.tar.gz
• mipsel: https://bin.entware.net/mipselsf-k3.4/installer/mipsel-installer.tar.gz
• mips: https://bin.entware.net/mipssf-k3.4/installer/mips-installer.tar.gz

Or search for the installer according to your router model.

• Search site: https://support.keenetic.com/?lang=en
• For example KN-1012: https://support.keenetic.com/hero/kn-1012/en/18482-installing-opkg-entware-in-the-router-s-internal-memory.html

After Downloading the Installer Package

• Go to the Applications page.
  
• Click Internal storage, open File Browser, click Create a new folder.
  
• Name the new folder install, then Save.
  
• Select the install folder and upload the downloaded installer package.
  

Deploy Entware and Install It to the Disk

• First exit, then run the command
  
• In the router's command-line interface (CLI), select the system partition storage:/ to install OPKG Entware:
  
• Type opkg disk storage:/ and press Enter

Check System Log

Then go to the router's web UI, search for "log" in the top-right, and open System log

You can view the Entware installation logs there. If the System log shows 'Critical error' or an error related to /opt/bin/install, stop the installation and collect the following information:

• Full System log
• Router brand and model
• Firmware version
• Storage type: internal storage or USB drive
• GearUP user ID

Send this information to GearUP Support. Do not repeatedly reinstall or delete Entware unless support instructs you to do so.

Waiting for Installation

The installation may take 10 minutes, or even up to half an hour.

Entware installation is complete only when both conditions are met:

1. The System log contains: [5/5] "Entware" installed!
2. SSH login on port 222 succeeds.

For the first login, use username root and the temporary default password keenetic. Immediately change the password by running:passwd root

After login succeeds, you should see a command prompt similar to:

~ #

or:

/root #

This means that you are already connected to the Entware SSH environment.

Do not run the SSH command again. Run the GearUP installation commands below directly at this prompt.

Step 3: Install the GearUP Router Plugin

Run the Installation Command

Run the following command in Windows Terminal, PowerShell, or a terminal app such as Termius. Do not enter it in Keenetic Web CLI:

ssh -p 222 [email protected]

Replace 192.168.1.1 with your router gateway IP. Do not type brackets or an asterisk.

For PuTTY, use:

• Connection type: SSH
• Port: 222
• Username: root

Do not use Telnet or port 23.

Download the installation script first, then run it. This keeps download errors visible while retaining the current sdp.gg domain.

In the wget command, the character in -O is the uppercase letter “O”, not the number “0”.

For Keenetic:
wget -S -T 30 -O /tmp/gearup-install.sh http://sdp.gg/ke
sh /tmp/gearup-install.sh

For Netcraze:
wget -S -T 30 -O /tmp/gearup-install.sh http://sdp.gg/ne
sh /tmp/gearup-install.sh

Wait for the Installation to Finish

Do not close the terminal or enter another command while the installation script is running.

The installation process has finished when:

• The script stops running.
• No error message is displayed.
• The ~ # or /root # command prompt appears again.

Compare your result with the successful installation example below.

Do not open the GearUP Router App or start binding the router until the installation has finished successfully.

Bind the Router by Following the Steps Below

1. Connect your phone to the Keenetic or Netcraze router's Wi-Fi, then use the GearUP Router App to bind the device.
   
2. After the SSH installation finishes successfully, connect your phone to the same router's main Wi-Fi network. Open the GearUP Router App, tap Install Router Plugin, select Keenetic or Netcraze, and bind the detected router to your GearUP account.
   
3. After installation is complete, tap the top-left corner to switch the device to the router with the plugin installed, then select the device and game to start boosting.

Troubleshooting:

• 'no such command: ssh': You entered the SSH command inside Keenetic Web CLI. Run it from Windows Terminal, PowerShell, PuTTY, or Termius instead.
• 'Connection refused' on port 222: Entware installation is incomplete or the Entware SSH service is not running. Check the System log.
• 'Prepended http://': This message is not an error. It means the router added the protocol automatically.
• 'opkg update failed': Check the full error. A broken third-party repository can stop the GearUP installation even when the official Entware repositories work.
• 'Router not supported' or 'Unknown': Confirm that the installation command completed without errors and that the phone is connected to the same router's main Wi-Fi network. Do not use guest Wi-Fi or switch SSIDs during binding.

If the issue remains, submit feedback from the GearUP Router App and include the router model, firmware version, GearUP user ID, and full error screenshot.