Android Debug Bridge version 1.0.41

Global options

Listen on all network interfaces, not just localhost

adb -a

Use USB device (error if multiple devices connected)

adb -d

Use TCP/IP device (error if multiple TCP/IP devices available)

adb -e

Use device with given serial (overrides $ANDROID_SERIAL)

adb -s SERIAL

Use device with given transport id

adb -t ID

Name of adb server host [default=localhost]

adb -H

Port of adb server [default=5037]

adb -P

Listen on given socket for adb server [default=tcp:localhost:5037]


General commands

List connected devices (-l for long output)

adb devices [-l]

Show this help message

adb help

Show version num

adb version


Connect to a device via TCP/IP

adb connect HOST[:PORT]

Disconnect from given TCP/IP device, or all

adb disconnect [[HOST]:PORT]

List all forward socket connections

adb forward --list

Forward socket connection using:

adb forward [--no-rebind] LOCAL REMOTE

Remove specific forward socket connection

adb forward --remove LOCAL

Remove all forward socket connections

adb forward --remove-all

Run PPP over USB

adb ppp TTY [PARAMETER...]

List all reverse socket connections from device

adb reverse --list

Reverse socket connection using:

adb reverse [--no-rebind] REMOTE LOCAL

Remove specific reverse socket connection

adb reverse --remove REMOTE

Remove all reverse socket connections from device

adb reverse --remove-all

File transfer

Copy local files/directories to device

adb push [--sync] LOCAL... REMOTE

Copy files/dirs from device

adb pull [-a] REMOTE... LOCAL

Sync a local build from $ANDROID_PRODUCT_OUT to the device (default all)

adb sync [all|data|odm|oem|product|system|system_ext|vendor]


Run remote shell command (interactive shell if no command given)

adb shell [-e ESCAPE] [-n] [-Tt] [-x] [COMMAND...]

Run emulator console command

adb emu COMMAND

App installation

Push a single package to the device and install it

adb install [-lrtsdg] [--instant] PACKAGE

Push multiple APKs to the device for a single package and install them

adb install-multiple [-lrtsdpg] [--instant] PACKAGE...

Push one or more packages to the device and install them atomically

adb install-multi-package [-lrtsdpg] [--instant] PACKAGE...

--local-agent: locate agent files from local source build (instead of SDK location)

(See also adb shell pm help for more options.)

Remove this app package from the device

adb uninstall [-k] PACKAGE


Write bugreport to given PATH []; If PATH is a directory, the bug report is saved in that directory. Devices that don't support zipped bug reports output to stdout.

adb bugreport [PATH]

List pids of processes hosting a JDWP transport

adb jdwp

Show device log (logcat --help for more)

adb logcat


Disable dm-verity checking on userdebug builds

adb disable-verity

Re-enable dm-verity checking on userdebug builds

adb enable-verity

Generate adb public/private key; Private key stored in FILE,

adb keygen FILE


Wait for device to be in the given state

adb wait-for[-TRANSPORT]-STATE

Print offline | bootloader | device

adb get-state

Print <serial-number>

adb get-serialno

Print <device-path>

adb get-devpath

Remount partitions read-write. If a reboot is required, -R will will automatically reboot the device.

adb remount [-R]

Reboot the device; Defaults to booting system image but supports bootloader and recovery too. Sideload reboots into recovery and automatically starts sideload mode, sideload-auto-reboot is the same but reboots after sideloading.

adb reboot [bootloader|recovery|sideload|sideload-auto-reboot]

Sideload the given full OTA package

adb sideload OTAPACKAGE

Restart adbd with root permissions

adb root

Restart adbd without root permissions

adb unroot

Restart adbd listening on USB

adb usb

Restart adbd listening on TCP on PORT

adb tcpip PORT

Internal debugging

Ensure that there is a server running

adb start-server

Kill the server if it is running

adb kill-server

Kick connection from host side to force reconnect

adb reconnect

Kick connection from device side to force reconnect

adb reconnect device

Reset offline/unauthorized devices to force reconnect

adb reconnect offline

Environment variables

Comma-separated list of debug info to log:


Colon-separated list of keys (files or directories)


Serial number to connect to (see -s)


Tags to be used by logcat (see logcat --help)