Skip to content

CONFIGURATION

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 | 中文


Configuration

Settings live in /data/adb/vddropbear/config (seeded from module/common/config.default on first boot). The WebUI edits this file for you; you can also edit it by hand. It is sourced as shell, so use KEY=value with no spaces around =. Settings are not secret and live on device-encrypted storage; secrets (host keys, authorized keys, password hashes) live in the secret store, never here.

Apply changes by restarting the daemon (the WebUI's Save & restart does this).

General

Key Default Meaning
ENABLED 1 Start the daemon at boot. 0 disables it entirely.
START_IN_BFU 0 0: start only after first unlock (AFU); secrets stay on credential-encrypted (CE) storage. 1: also start before first unlock (BFU); secrets move to device-encrypted (DE) storage, readable before unlock.
PORT 2222 Default listening port (per-bind ports can override it in LISTEN_ADDRESSES).

Listening / binds (composable)

Any combination is allowed; the selected binds are merged. If you clear everything, VD Dropbear binds loopback rather than every interface.

Key Default Meaning
LISTEN_LOOPBACK 1 Listen on 127.0.0.1 / ::1 only.
LISTEN_ALL 0 Listen on every interface (0.0.0.0 / ::); exposes the device.
LISTEN_IPV4 1 Include IPv4 binds.
LISTEN_IPV6 1 Include IPv6 binds.
LISTEN_ADDRESSES "" Extra specific binds, comma-separated: addr (uses PORT) or addr:port, IPv4 or IPv6.

SSH over USB (no wifi, no ADB). Turn on the phone's USB tethering and add its USB address (usually 192.168.42.129) to LISTEN_ADDRESSES, with LISTEN_ALL off. The daemon is then reachable only through the cable, which is typically faster and steadier than wireless for large transfers.

Identity

Key Default Meaning
HIDE_IDENT 1 Send a neutral SSH identity banner so scanners cannot fingerprint the exact server/version.
IDENT_STRING "" A custom identity string. Empty uses the neutral built-in default.

Authentication

A login runs as the account you authenticate as: root by default, or a lower-privilege account (shell, system). Keys are the default; passwords are opt-in.

Key Default Meaning
PUBKEY_AUTH 1 Allow public-key login (reads the authorized keys in the secret store).
PASSWORD_AUTH 0 Allow password login. When off, the daemon is started with password auth disabled.
MAX_AUTH_TRIES 3 Maximum authentication attempts per connection.

Session / environment

Key Default Meaning
LOGIN_SHELL "" Shell for the session. Empty uses the account default.
HOME_DIR "" HOME for the session. Empty uses the module directory.
EXTRA_ENV "" Extra environment, K=V;K2=V2.
IDLE_TIMEOUT 0 Disconnect after N idle seconds. 0 disables.
KEEPALIVE 0 Send a keepalive every N seconds. 0 disables.
RECEIVE_WINDOW "" Dropbear receive window size. Empty uses the default.

Forwarding (off by default)

Key Default Meaning
ALLOW_LOCAL_FORWARD 0 Allow local (-L) port forwarding.
ALLOW_REMOTE_FORWARD 0 Allow remote (-R) port forwarding.
GATEWAY_PORTS 0 Let forwarded remote ports bind to all interfaces.

Host key

Key Default Meaning
HOSTKEY_TYPE ed25519 Host-key type: ed25519, rsa or ecdsa. Generated on first start into the secret store.

The secret store

Not configured here; resolved from START_IN_BFU:

  • AFU (default): /data/misc_ce/0/vddropbear/secret, credential-encrypted, available only after you unlock the device.
  • BFU: /data/adb/vddropbear/secret, device-encrypted, readable before first unlock.

It holds the host key, authorized_keys, and the passwd hash file. See BUILDING.md for the password hash format.


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

Clone this wiki locally