Debug Android apps over WiFi without USB cables. Learn both Android 11+ native wireless debugging with QR code pairing and legacy TCP/IP mode for older devices.
Why Wireless Debugging?
Cable debugging works, but it has limitations: cables break, USB ports wear out, and you’re physically tethered to your desk. Wireless ADB debugging eliminates these friction points by connecting your Android device to your development machine over WiFi.
Benefits:
- Work cable-free from anywhere on your network
- Test multiple devices simultaneously without USB hub hassles
- Preserve USB ports (especially useful on laptops with limited ports)
- Faster iteration when testing on real devices across the room
- No more “USB debugging disconnected” interruptions
Android offers two wireless debugging methods depending on your device’s Android version. We’ll cover both.
Prerequisites
Before starting, ensure you have:
- Android Debug Bridge (ADB) installed on your computer (part of Android SDK Platform Tools)
- Android device with Developer Options enabled and USB debugging turned on
- Same WiFi network: Both your computer and Android device must be on the same wireless network
- Android 11+ for native wireless debugging (recommended), or Android 10 and below for legacy TCP/IP mode
Check your ADB version:
adb version
You should see Android Debug Bridge version 1.0.41 or higher.
Method 1: Android 11+ Native Wireless Debugging (Recommended)
Android 11 introduced built-in wireless debugging with secure pairing and automatic reconnection. This is the recommended method for modern devices.
Enable Wireless Debugging
- Open Settings on your Android device
- Navigate to System → Developer options
- Scroll down to Wireless debugging
- Toggle Wireless debugging ON
- Accept the permission prompt if shown
💡 Pro Tip: Keep the Wireless debugging screen open while pairing. The screen displays connection status and active devices.
Pairing Method A: QR Code (Easiest)
The QR code method is the fastest and most convenient way to pair.
On your Android device:
- In Wireless debugging settings, tap Pair device with QR code
- Your device will open the camera to scan a QR code
On your computer:
If using Android Studio:
- Open Android Studio
- Go to Device Manager (icon in toolbar)
- Click Physical tab
- Click Pair using WiFi
- Select Pair using QR code
- Android Studio generates and displays a QR code
- Scan the QR code with your Android device
- Connection established automatically
Result: Device instantly pairs and connects. No IP addresses or pairing codes needed.
Pairing Method B: Manual IP and Pairing Code
If QR code scanning isn’t available, use manual pairing.
On your Android device:
- In Wireless debugging settings, tap Pair device with pairing code
- Note the displayed information:
- IP address (e.g.,
192.168.1.100) - Port (e.g.,
37043) - 6-digit pairing code (e.g.,
582914)
- IP address (e.g.,
On your computer:
adb pair 192.168.1.100:37043
When prompted, enter the 6-digit pairing code:
Enter pairing code: 582914
Expected output:
Successfully paired to 192.168.1.100:37043 [guid=adb-1A2B3C4D5E6F-ABCDEF]
Connect After Pairing
Once paired, you can connect using the connection port (different from pairing port).
On your Android device:
- Go back to main Wireless debugging screen
- Look for IP address & Port under device name
- Example:
192.168.1.100:41053
- Example:
On your computer:
adb connect 192.168.1.100:41053
Expected output:
connected to 192.168.1.100:41053
Verify connection:
adb devices
Output shows your device:
List of devices attached 192.168.1.100:41053 device
🔔 Important: The pairing port (used once during adb pair) is different from the connection port (used for adb connect). Don’t confuse them.
Method 2: Legacy TCP/IP Mode (Android 10 and Below)
Older Android versions don’t have native wireless debugging. Use this USB-assisted method instead.
Initial USB Connection Required
Step 1: Connect via USB
- Connect your Android device to computer via USB cable
- Ensure USB debugging is enabled
- Accept the “Allow USB debugging?” prompt on device
Verify USB connection:
adb devices
Step 2: Switch to TCP/IP Mode
Enable ADB to listen on TCP port 5555:
adb tcpip 5555
Step 3: Find Device IP Address
On your Android device: Settings → About phone → Status (or Network & internet → WiFi → tap connected network)
Step 4: Disconnect USB Cable
You can now physically disconnect the USB cable.
Step 5: Connect via WiFi
adb connect 192.168.1.100:5555
Troubleshooting Common Issues
| Issue | Cause | Solution |
|---|---|---|
| “Connection refused” | Wrong port or device not listening | Check connection port on device, ensure Wireless debugging is ON |
| “Unable to connect” | Different WiFi networks | Verify both devices on same network, check firewall |
| “Device offline” after connecting | Stale connection or network change | adb disconnect then adb connect again |
| Pairing code doesn’t work | Code expired (60 second timeout) | Generate new pairing code on device |
| Connection drops frequently | Weak WiFi signal or power saving | Move closer to router, disable battery optimization |
Security Considerations
⚠️ Security Warning: Wireless debugging exposes ADB over the network. Anyone on your WiFi can potentially connect to your device if they know the IP and port.
Best Practices:
- Use Android 11+ native wireless debugging — includes pairing authentication
- Disable wireless debugging when not in use — turn off when development session ends
- Use trusted networks only — avoid public WiFi when wireless debugging is enabled
- Legacy TCP/IP mode is less secure — no authentication after initial USB connection
Comparison: Wireless Debugging Methods
| Feature | Android 11+ QR Code | Android 11+ Manual | Legacy TCP/IP |
|---|---|---|---|
| Setup Complexity | ⭐⭐⭐⭐⭐ Easiest | ⭐⭐⭐⭐ Easy | ⭐⭐⭐ Moderate |
| Initial USB Required | No | No | Yes |
| Authentication | QR code | 6-digit code | None after USB |
| Persists After Reboot | Yes (if enabled) | Yes (if enabled) | No |
| Security | High | High | Low |
| Android Version | 11+ | 11+ | 10 and below |
Next Steps
You’re now wireless. Continue mastering ADB:
- Learn essential ADB commands for app installation, file transfer, and debugging
- Understand how ADB works to troubleshoot connection issues
- Set up Android Studio to leverage wireless debugging in your IDE
- Developer Tools: Compare GitHub Copilot, Cursor, and Claude Code for AI-assisted coding
Wireless ADB debugging eliminates cable frustrations and accelerates your Android development workflow. Whether using Android 11+ native wireless debugging or legacy TCP/IP mode, you’re now equipped to debug cable-free.
Related Guides:
- What is ADB? Android Debug Bridge Explained
- How to Install ADB on Windows, Mac, and Linux
- Essential ADB Commands Every Developer Should Know
- Common ADB Problems and How to Fix Them
Sources:
- Android Debug Bridge (adb) – Android Developers
- Wireless Debugging – Android Studio
- ADB over WiFi – ChromeOS Developers
- How to Enable Android 15 Theft Protection and Private Space
Last updated: September 2, 2026
1 thought on “How to Set Up Wireless ADB Debugging on Android”