Console

Settings

Sign out

Notifications

Alexa

Amazon Appstore

Ring

AWS

Documentation

Support

My Cases

Console

Vega Developer Docs

Home

Get Started

Design and Develop

Publish

Reference

Support

Configure VDA Over TCP/IP for Fire TV Devices

Open Beta Documentation Amazon offers this technical documentation as part of a pre-release, open beta. The features described might change as Amazon receives feedback and iterates on the features. For the most current feature information, see the latest Release Notes.

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.

Important: Developer mode is the recommended environment for all development activities.

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.

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:

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:
Copied to clipboard.
```
vega exec vda devices
```
Example output:
```
List of devices attached
G000XX0123456789    device
```
Restart VDA in TCP/IP mode using port 5555 (or a custom port greater than 1024):
Copied to clipboard.
```
vega exec vda tcpip 5555
```
Example output:
```
restarting in TCP mode port: 5555
```
Warning: 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>:5555

Example output:

connected to <device_ip_address>:5555

Verify the connection:

Copied to clipboard.

vega exec vda devices

Example output:

List of devices attached
192.168.1.100:5555    device

(Optional) To return to USB mode, reconnect the USB cable and run:
Copied to clipboard.
```
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>:5555
```
Replace <device_ip_address> with your device's IP address. If you configured a custom port, replace 5555 with your custom port number.

Example output:
```
connected to <device_ip_address>:5555
```

Verify the connection:

Copied to clipboard.

vega exec vda devices

Example 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.

Work with TCP/IP-connected devices

After connecting through TCP/IP, the device appears with an <ip>:<port> 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 <ip>:<port> identifier:

vega exec vda -s 192.168.1.100:5555 shell

You can also set the VEGA_SERIAL environment variable to the TCP/IP identifier:

export VEGA_SERIAL=192.168.1.100:5555
vega exec vda shell

Retrieve the Device Serial Number (DSN)

When a device is connected through TCP/IP, you might need the DSN for tools such as Appium. Use get-serialno to retrieve the DSN directly:

Copied to clipboard.

vega exec vda -s <ip>:<port> get-serialno

Example:

vega exec vda -s 192.168.1.100:5555 get-serialno

Example output:

GT533M06507401WA

Alternatively, you can query the device configuration manager directly:

vega exec vda -s <ip>:<port> shell vdcm get com.amazon.devconf/system/device-info/device-serial

Note: These commands require Developer Mode to be enabled on the device.

Troubleshooting

If you encounter issues using VDA over TCP/IP, see Fix VDA Connection and Power Issues.

Last updated: Jul 30, 2026

Configure VDA Over TCP/IP for Fire TV Devices

Prerequisites

Configure TCP/IP connection

Configure standard port

Configure a custom port

Connect from your host machine

Work with TCP/IP-connected devices

Target a TCP/IP-connected device

Retrieve the Device Serial Number (DSN)

Troubleshooting

Related topics