Prerequisites
Before you configure VDA over TCP/IP, ensure:- Your Fire TV device has completed initial setup and you can access the home screen.
- Your Fire TV device runs the latest OS version (check at Settings > My Fire TV > About > Check for Updates).
- You have Developer Mode enabled on your Fire TV device.
- Your Fire TV device and host machine are on the same network with port 5555 (or your chosen custom port) unblocked.
- You have your Fire TV device’s IP address. Go to Settings > My Fire TV > About > Network and note the IP address.
Configure TCP/IP connection
Choose your preferred configuration method:- CLI
- Fire TV Settings UI
Use the CLI method when you need to automate device setup or integrate into scripts.
-
Connect your Fire TV device through USB and verify the connection:
Example output:
-
Restart VDA in TCP/IP mode using port 5555 (or a custom port greater than 1024):
Example output:
- Disconnect the USB cable from your Fire TV device.
-
Connect to your Fire TV device using its IP address:
Example output:
-
Verify the connection:
Example output:
-
(Optional) To return to USB mode, reconnect the USB cable and run:
Work with TCP/IP-connected devices
After connecting through TCP/IP, the device appears with an identifier instead of the physical serial number in thevega exec vda devices output.
Target a TCP/IP-connected device
To direct VDA commands to a specific TCP/IP-connected device, use the-s flag with the identifier:
VEGA_SERIAL environment variable to the TCP/IP identifier:
Retrieve the Device Serial Number (DSN)
When a device is connected through TCP/IP, you might need the DSN for tools such as Appium. Useget-serialno to retrieve the DSN directly:
