solana-mobile device - Solana Mobile Docs

Work with Android devices and emulators connected over adb.

device install

Install APKs from local files, directories, or the built-in APK catalog. Run it without arguments to pick from the catalog, which includes tools like the Mobile Wallet Adapter test wallet (fakewallet):

npx solana-mobile@latest device install

pnpm dlx solana-mobile@latest device install

bunx solana-mobile@latest device install

Or pass one or more APK files or directories:

npx solana-mobile@latest device install ./app-release.apk --all

pnpm dlx solana-mobile@latest device install ./app-release.apk --all

bunx solana-mobile@latest device install ./app-release.apk --all

Option	Description
`--all`	Install on every connected device
`--device <serial>`	Target a device serial
`--downgrade`	Allow version downgrades (`adb install -d`)
`--force`	Re-download catalog APKs even when cached
`--grant`	Grant all runtime permissions (`adb install -g`)
`--list`	List the APKs available in the catalog
`-v, --verbose`	Verbose output

device list

List connected devices and emulators:

npx solana-mobile@latest device list

pnpm dlx solana-mobile@latest device list

bunx solana-mobile@latest device list

Option	Description
`--json`	Print a stable JSON report

device open

Open a URL, port, or deep link on a connected device. For localhost URLs with an explicit port, the CLI creates an adb reverse (unless --no-forward is set) so the device can reach servers running on your machine:

npx solana-mobile@latest device open http://localhost:3000

pnpm dlx solana-mobile@latest device open http://localhost:3000

bunx solana-mobile@latest device open http://localhost:3000

Option	Description
`--device <serial>`	Target a device serial
`--no-forward`	Do not create an adb reverse for localhost URLs
`-v, --verbose`	Explain URL and port forwarding decisions

Last modified on September 1, 2026