Skip to content

Quick start

From a rooted Android device to a working router in five steps, with the AndroidWrt Lite app.

Before you start

  • An Android device running Android 8.0 or later on arm64, rooted with KernelSU or Magisk. On the Samsung SCR01, read the device notes first.
  • A computer with the tools from Building from source, and USB debugging turned on on the device.

There is no official release yet, so the app is built from source. It takes a few minutes.

1. Root the device

Use KernelSU or Magisk as usual for your device. On the SCR01, whose bootloader is locked, root comes from SCRoot: turn on its Run at boot option so root comes back after every reboot.

2. Build

git clone https://github.com/AndroidWrt/core.git && cd core
./cores/fetch-cores.sh   # download Xray, SmartDNS and the geo data (first time only)
./build.sh               # build the web panel and rebornd into dist/rebornd
./android/build.sh       # build the Lite app into dist/androidwrt-lite.apk

3. Install and start

With the device connected over USB:

./deploy/deploy.sh --apk   # install the app and start AndroidWrt

Or copy dist/androidwrt-lite.apk to the device and install it there. Open AndroidWrt Lite, allow root when KernelSU or Magisk asks, and tap Start AndroidWrt.

With Start at boot on (the default), the app brings AndroidWrt back after every reboot as soon as root is available again, even before the device is unlocked for the first time.

4. Open the panel

  • On the device: tap Open web panel in the app.
  • From a hotspot client: browse to http://<device-ip>:9000.
  • Over USB: run adb forward tcp:9000 tcp:9000, then browse to http://127.0.0.1:9000.

The default login is admin / admin. Change it right away under System → Administration. SSH uses the same password: ssh root@<device-ip>.

By default the firewall rejects connections from the wan zone (cellular, upstream Wi-Fi, Type-C WAN), so the panel and SSH are reachable only from the hotspot, from USB tethering or through adb forward. To open them to the upstream network, add a rule under Network → Firewall → Traffic Rules.

5. Route the hotspot through the proxy

  1. Services → Proxy → Node List: import share links, or add a subscription under Node Subscribe.
  2. Basic Settings: pick a node (or Shunt for rule-based routing) and adjust DNS and the mode if needed.
  3. Rule Manage → Rule status: on first use, run Manually update for the GFW and China lists and the geo data.
  4. Turn on the Transparent proxy switch in the top bar.
  5. Connect your other devices to the hotspot. Their traffic now goes through the proxy, with nothing to set up on them.
PreviousIntroductionNext Operating modes