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
- On the phone's Owner (main) profile, open Settings > About phone.
- Tap Build number 7 times.
You should see "You are now a developer!". Do this on the Owner profile, because USB debugging lives there.

Turn On USB Debugging
- Open Settings > System > Developer options.
- Turn on USB debugging.
Optional: turn on Stay awake in the same list so the screen doesn't sleep while the phone charges.

Add the Phone in ShadowPhone
- In ShadowPhone, open Phones and click Add phone. Keep USB cable selected.
- Plug the phone into the computer with a USB-C cable that carries data.
- 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.

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.

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.