Docs/Phone Setup/Connecting Your Phone via USB
Phone Setup

Connecting Your Phone via USB

Connect a Google Pixel running GrapheneOS to ShadowPhone Desktop over USB: turn on USB debugging, allow the computer, and fix common connection issues.

Turn On Developer Options

  1. On the phone's Owner (main) profile, open Settings > About phone.
  2. Tap Build number 7 times.

You should see "You are now a developer!". Do this on the Owner profile, because USB debugging lives there.

Android About phone screen with Build number at the bottom
Settings > About phone. Tap Build number 7 times.

Turn On USB Debugging

  1. Open Settings > System > Developer options.
  2. Turn on USB debugging.

Optional: turn on Stay awake in the same list so the screen doesn't sleep while the phone charges.

USB debugging switch turned on in Developer options
Settings > System > Developer options on a GrapheneOS Pixel.

Add the Phone in ShadowPhone

  1. In ShadowPhone, open Phones and click Add phone. Keep USB cable selected.
  2. Plug the phone into the computer with a USB-C cable that carries data.
  3. On the phone, tick Always allow from this computer and tap Allow.

The window shows Waiting for a phone on USB... until the phone connects. You should then see the phone's name followed by "connected". Click Done. If it says the phone was found but is waiting, unlock the phone and tap Allow.

Add a phone window with USB cable selected, three steps (turn on USB debugging, plug it in, tap Allow) and the status Waiting for a phone on USB
Phones > Add phone. The status line changes as soon as the phone connects.

Check the Phone Card

Each phone gets a card in Phones with its status (for example Connected · USB · 100%), its model, system and serial, a profile picker, the accounts on it, and Share, Mirror and Run buttons.

If the card says Waiting for Allow, unlock the phone, tap Allow on the USB debugging prompt, then click Refresh. Still stuck: Troubleshooting Connection Issues.

Phones tab with two phone cards showing Connected, USB and battery, model, system and serial, a profile picker, accounts, and Share, Mirror and Run buttons, next to an Add phone tile
One card per phone. The second line shows the model, system and serial: check it says GrapheneOS.

Several Phones

Connect more phones the same way. For several phones, use a powered USB hub so every phone gets enough power. Fleet Tools on Overview has Mirror All and Stop Mirrors to open or close every phone screen at once.

No Cable Nearby?

Add phone > Pair wirelessly (no USB) pairs a phone on the same Wi-Fi, and Remote phone adds one over Tailscale. USB is the most reliable. See WiFi & Remote Access.

GrapheneOS Profiles

GrapheneOS profiles separate app data and profile storage on the same physical phone. Hardware and the default network path remain shared. ShadowPhone lists a phone's profiles in its card's profile picker and switches between them; profile isolation does not make account operation universally safe.

Need more help?

Contact support for help with your setup, or browse the rest of the docs.