Skip to content

USER GUIDE

github-actions[bot] edited this page Nov 17, 2026 · 5 revisions

Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文


User guide

VD Dropbear gives your rooted device a private SSH server. This guide takes you from install to a working connection, including file transfer and the before-first-unlock (BFU) mode.

A login defaults to a full root shell. Prefer keys over passwords, bind only to networks you trust, and never expose the port to the open Internet without a reason.

1. Install

Flash the module zip in the KernelSU, APatch or Magisk manager (or from a shell with ksud module install / apd module install), then open the module's WebUI.

2. Add a key (recommended)

In the WebUI, under Authorized keys, paste your public key (ssh-ed25519 AAAA... you@host) and press Add key. Keys are the default and the safest way in.

To generate a key on your computer, if you do not have one:

ssh-keygen -t ed25519 -C "you@host"
cat ~/.ssh/id_ed25519.pub     # paste this into the WebUI

3. Or set a password

Password login is off by default (a login defaults to root, so keys are preferred). To enable it, turn on Password login in the settings, then under Password accounts set a password for the login user. The hash is computed in your browser with PBKDF2; the password itself never leaves the page.

4. Pick a port and where to listen

Under Settings, set the Port and choose the binds. By default VD Dropbear listens only on loopback; to reach it from your LAN or a VPN, enable the interfaces you want. Avoid Listen on all interfaces unless you understand the exposure.

Press Save & restart to apply, then Start if it is not already running.

5. Connect

ssh -p 2222 root@<device-ip>
sftp -P 2222 root@<device-ip>
scp -P 2222 file root@<device-ip>:/sdcard/
rsync -e 'ssh -p 2222' -av ./dir/ root@<device-ip>:/sdcard/dir/

sftp-server, scp and rsync are bundled, so SFTP, sshfs, GUI clients and backups all work over the same connection.

Connect over USB (no wifi, no ADB)

For faster, steadier transfers with no network in the path, reach the daemon over the USB cable using USB tethering, no ADB or USB debugging involved:

  1. Plug in the cable, then on the phone turn on USB tethering (Settings -> Network -> Hotspot and tethering).
  2. The phone joins a small USB-only network, usually at 192.168.42.129.
  3. Back in step 4 above, add that address to the specific binds (LISTEN_ADDRESSES) and leave all interfaces off, so the daemon answers only through the cable.

Then connect to the USB address instead of the wireless one:

ssh -p 2222 root@192.168.42.129
scp -P 2222 file root@192.168.42.129:/sdcard/

If 192.168.42.129 is not the address on your device, check the phone's USB interface with ip addr.

6. Before first unlock (BFU)

By default the daemon starts only after you unlock the device once (AFU), because its secrets live on credential-encrypted storage. If you need SSH before first unlock (for example to unlock a device remotely after a reboot), turn on Start before first unlock (BFU). The secrets then move to device-encrypted storage, which is readable before unlock: a deliberate, documented trade-off. See Security model in the README.

7. Controlling the daemon

  • WebUI: Start / Stop / Restart, and live status (running, PID, port, mode, host-key fingerprint).
  • Manager Action button: (re)launches the daemon.
  • It also starts automatically at boot (unless you disable it).

Troubleshooting

  • It will not start. Check /data/adb/vddropbear/state/daemon.log. Make sure Enabled is on and a host key could be generated.
  • Key rejected. Confirm the public key line is exactly as your client offers it, and that the username you log in as is one the system resolves (usually root).
  • Can't connect from another machine. You are probably still bound to loopback only; enable the interface you need and restart.
  • SFTP/scp fails but shell works. Make sure the bundled sftp-server shipped for your ABI; the WebUI status shows the detected ABI.

This documentation was generated with Claude (Anthropic) and is maintained by VD171. Corrections and improvements are welcome; see CONTRIBUTING.md.

Clone this wiki locally