Amazon Developer

Console

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases

Console

as

Get Started
Design and Develop
Publish
Reference
Support
Skip to main content
Vega Device Adapter (VDA) lets you interact with and debug Fire TV devices. By default, VDA uses a USB connection, but you can configure it to work over TCP/IP for wireless debugging.

​
Prerequisites

Before you configure VDA over TCP/IP, ensure:
  1. Your Fire TV device has completed initial setup and you can access the Fire TV home screen.
  2. Your Fire TV device runs the latest OS version. To check for updates, go to Settings > My Fire TV > About and select Check for Updates. Install any available updates before proceeding.
  3. You have Developer Mode enabled on your Fire TV device.
  4. You connect your Fire TV device to the same network as your host machine. Ensure your network firewall does not block connections on port 5555 (or your chosen custom port) between the host and the device.
  5. 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:
Use the CLI method when you need to automate device setup or integrate into scripts.
  1. Connect your Fire TV device through USB and verify the connection:
    Example output:
  2. Restart VDA in TCP/IP mode using port 5555 (or a custom port greater than 1024):
    Example output:
  3. Disconnect the USB cable from your Fire TV device.
  4. Connect to your Fire TV device using its IP address:
    Example output:
  5. Verify the connection:
    Example output:
  6. (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 the vega 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:
You can also set the VDA_SERIAL environment variable to the TCP/IP identifier:

​
Retrieve the physical device serial number

When a device is connected through TCP/IP, you might need the physical serial number for tools such as Appium. To retrieve the physical serial number from a TCP/IP-connected device, run:
Example:
Example output:

​
Troubleshooting

If you encounter issues using VDA over TCP/IP, see Fix VDA Connection and Power Issues.
Last modified on June 12, 2026