Google is committed to advancing racial equity for Black communities. See how.


device-finder is the command line tool for device discovery. It uses mDNS to find Fuchsia devices.

Currently only Linux is supported. For Mac users see the section for Mac Users.

For Linux Users

Finding all Devices

The simplest way to get all the devices on the network by their address is to run

$ ./device-finder list

This will give you the addresses of all Fuchsia devices on the network. If you'd like to get their hostnames as well as their addresses, you can include the -full flag. If you also want to find Fuchsia emulator (FEMU) devices use the -netboot flag.

Finding devices by hostname

If you'd like to find your device by its unique hostname (e.g. lunch-feta-stool-woozy) you can use the resolve command:

$ ./device-finder resolve lunch-feta-stool-woozy

Finding the Interface Connected to the Device

To find the interface connected to the device, include the -local flag to either the list command or the resolve command, which will give you the address that the Fuchsia device can use to connect to your host.

For Mac Users

For those on Mac hosts, you can use the included dns-sd command to find your device. Here's an example command along with the output you should see when a device is on your network:

$ dns-sd -B _fuchsia._udp .
Browsing for _fuchsia._udp
DATE: ---Fri 14 Dec 2018---
15:28:21.447  ...STARTING...
Timestamp     A/R    Flags  if Domain       Service Type   Instance Name
15:28:21.448  Add        2   7 local.       _fuchsia._udp. quake-agile-lurk-even

Mac does not support the equivalent of a local flag as described above in the device-finder docs.

For additional help

For additional help using any of the device-finder subcommands, run the subcommand with the -help flag.