Connect Phoma to Android Over Wi-Fi Using Wireless ADB Debugging

November 7, 2026

Running the same checks on Android phones every day means plugging and unplugging USB cables all the time. If your test phones sit on a charging rack or move around a warehouse, a Wi-Fi connection to Phoma keeps them ready without touching a cable. This guide shows how to pair an Android phone with Phoma over Wi-Fi using wireless ADB debugging, what to do when a phone will not connect, and how to keep the link stable day to day.

Phoma runs flows on your own Windows PC and phones. It does not have a public API, SDK, or CLI, so device setup happens in the Phoma app. The adb commands below are only for preparing the phone with Android platform tools; you still add and run the phone from Phoma.

What You Need Before You Start

A Windows PC with Phoma installed
An Android phone on the same Wi-Fi network as the PC
A USB cable for the first pairing, recommended for all Android versions
Developer options enabled on the phone
The phone screen unlocked during setup

Step 1: Enable Developer Options and Wireless Debugging

On the phone, open Settings and tap About phone. Tap Build number seven times until you see a message that developer mode is on. Back out to System, then tap Developer options.

Turn on these settings:

USB debugging
Wireless debugging, available on Android 11 and later

If your phone runs Android 10 or earlier, you can still use Wi-Fi debugging, but you must start with a USB cable and the adb tcpip command described in Step 2.

When USB debugging is on and you plug the phone into Windows, tap Allow on the phone when the RSA authorization prompt appears. Check Always allow for this computer if you trust the PC.

Step 2: Put the Phone in Wireless Debug Mode

For Android 11 and newer, open Developer options and tap Wireless debugging. Tap Pair device with pairing code. The phone shows an IP address, a port, and a six-digit pairing code. Keep this screen open.

For older Android versions, connect the phone by USB once. Open a command prompt on the PC where Android platform tools are installed and run:

adb tcpip 5555

Then unplug the USB cable. Find the phone's Wi-Fi IP address in Settings under Network and internet or About phone, and run:

adb connect 192.168.1.42:5555

Replace 192.168.1.42 with your phone's actual IP address. If the command says connected, the phone is listening for wireless adb on port 5555.

These are Android platform tools, not Phoma commands.

Step 3: Add the Phone to Phoma Over Wi-Fi

Open Phoma on your Windows PC. Go to the Devices page and click Add device. Choose Wi-Fi or wireless debugging, depending on the option shown in your Phoma version.

Enter the phone's IP address and port from Step 2. For Android 11 and later, Phoma may also ask for the pairing code shown on the phone. Enter it and click Pair or Connect.

On the phone, accept any debugging authorization prompt. In Phoma, the device should change to Online. You can now select it when building or running a flow.

If you paired over USB first, the phone may stay discoverable on Wi-Fi until you restart it or toggle wireless debugging off.

Real-World Example

A QA tester supports three Android builds for a delivery app. Each morning she places five test phones on a shelf, connects them to power, and pairs each one to Phoma over Wi-Fi. Instead of crawling under desks to swap USB cables, she opens Phoma, selects all five devices, and starts the same smoke-test flow on all of them at once. When a phone drops offline, she checks the Wi-Fi icon and re-pairs it in under a minute.

Troubleshooting: Phone Will Not Connect to Phoma

Device does not appear in Phoma

First, confirm the PC and phone are on the same Wi-Fi network. Some routers split 2.4 GHz and 5 GHz into separate networks or isolate wireless clients, which blocks adb traffic.

Check these phone settings:

Developer options is on
USB debugging is authorized
Wireless debugging is on, for Android 11 and later
Screen is unlocked and not in a strict battery-saver mode

On the PC, confirm Phoma is not blocked by Windows Firewall. If you use adb manually, restart the server:

adb kill-server
adb start-server

Then refresh the Phoma device list.

Pairing code fails or expires

Wireless pairing codes expire quickly. Regenerate a new code on the phone and enter it right away. Pairing over Wi-Fi without USB requires Android 11 or later. On older phones, use the USB plus adb tcpip method instead.

If the phone's IP address changes after a router restart, the saved Phoma connection breaks. Set a static IP for the phone or create a DHCP reservation in your router settings.

Connected but flows do not run

Revoke USB debugging authorizations on the phone, then reconnect and allow the PC again. Avoid tapping Always allow on shared or public computers.

If Phoma shows the device as offline, remove it from the Devices page and add it again. Do not root the phone or install a custom ROM to fix connection issues; Phoma works with standard Android debugging.

Keep Wi-Fi Connections Stable

Enable Stay awake in Developer options so the screen does not lock while the phone is charging and idle. A locked screen does not always stop adb, but it can make mirroring and interaction less reliable.

Give test phones static IP addresses so Phoma always reaches them at the same address. If your office Wi-Fi has client isolation turned off, wireless adb should work across the same subnet.

When a phone receives a major Android update, debugging authorizations reset. Plan to re-pair the device after updates.

USB vs Wi-Fi: When to Use Each

Use USB for first-time setup, for phones that refuse to pair wirelessly, and for very large file transfers. Use Wi-Fi for daily flow runs, device farms on a bench, and situations where you need to start tests without walking to the phone.

Quick Checklist

Developer options and USB debugging enabled
Wireless debugging enabled on Android 11+
Phone and PC on same Wi-Fi network
IP address and port copied from the phone
Device added and marked Online in Phoma
RSA authorization accepted on the phone
Static IP or DHCP reservation for long-term test phones

Once a phone is online in Phoma, you can build visual flows, run them on one device or many, and schedule checks while the app stays open. No code is required to run the flow itself; the adb setup is only the connection step.