Configure VDA Over TCP/IP for Fire TV Devices
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:
- Your Fire TV device has completed initial setup and you can access the Fire TV home screen.
- 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.
- You have Developer Mode enabled on your Fire TV device.
- 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.
-
You have your Fire TV device's IP address:
Go to Settings > My Fire TV > About > Network and note the IP address.
Important: Obtain your device's IP address before switching to TCP/IP mode. After the device reboots into TCP/IP mode, you can't retrieve the IP address through a USB connection.
Configure TCP/IP connection
Choose your preferred configuration method:
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:
vega exec vda devicesExample output:
List of devices attached G000XX0123456789 device -
Restart VDA in TCP/IP mode using port 5555 (or a custom port greater than 1024):
vega exec vda tcpip 5555Example output:
restarting in TCP mode port: 5555Warning: Use port 5555 or any port greater than 1024. Ports below 1024 are blocked. -
Disconnect the USB cable from your Fire TV device.
-
Connect to your Fire TV device using its IP address:
vega exec vda connect <device_ip_address>:5555Example output:
connected to <device_ip_address>:5555 -
Verify the connection:
vega exec vda devicesExample output:
List of devices attached 192.168.1.100:5555 device -
(Optional) To return to USB mode, reconnect the USB cable and run:
vega exec vda usb
Use the Fire TV Settings UI to configure TCP/IP connectivity directly from your device. After you configure TCP/IP mode through the Settings UI, you still need to connect from your host machine using CLI commands (see Connect from your host machine).
Configure standard port
-
Go to Settings > My Fire TV > About > Developer Options
-
Choose Connection Mode to toggle between USB and TCP/IP modes.
You see the current Connection Mode (default: USB).
The Connection Mode option requires that your device runs the latest OS version with Developer Mode enabled. If you don't see the Connection Mode option under Developer Options, check for OS updates at Settings > My Fire TV > About > Check for Updates.
Warning: Toggling between USB and TCP/IP Connection Modes requires a system reboot. -
Choose Use standard port 5555.
-
Choose Continue.
-
Wait for the device to reboot.
Configure a custom port
-
Go to Settings > My Fire TV > About > Developer Options
-
Choose Change port.
-
Choose Connection Port and enter a custom port (greater than 1024).
-
Choose Continue.
-
Wait for the device to reboot.
Connect from your host machine
After you configure TCP/IP mode on your Fire TV device, connect from your host machine:
-
Connect to your Fire TV device using its IP address (from Prerequisites step 3):
vega exec vda connect <device_ip_address>:5555Replace
<device_ip_address>with your device's IP address. If you configured a custom port, replace5555with your custom port number.Example output:
connected to <device_ip_address>:5555 -
Verify the connection:
vega exec vda devicesExample output:
List of devices attached 192.168.1.100:5555 device -
(Optional) To return to USB mode, go to Settings > My Fire TV > About > Developer Options > Connection Mode and choose USB. The device reboots.
Troubleshooting
If you encounter issues using VDA over TCP/IP, see Fix VDA Connection and Power Issues.
Related topics
Last updated: Mar 24, 2026
