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 configuring 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 is connected to the same network as your host machine.
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:
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.

Note: After configuring TCP/IP mode via Settings UI, you'll still need to connect from your host machine using CLI commands (see steps after configuration).

Configure standard port

Go to Settings > My Fire TV > About > Developer Options
Select Connection Mode to toggle between USB and TCP/IP modes.

You see the current connection mode (default: USB).

Warning: Toggling between USB and TCP/IP Connection Modes requires a system reboot.
Select Use standard port 5555.
Select Continue.
Wait for the device to reboot.

Configure a custom port

Go to Settings > My Fire TV > About > Developer Options
Select Change port.
Select Connection Port and enter a custom port (greater than 1024).
Select Continue.
Wait for the device to reboot.

Connect from your host machine

After configuring 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 select USB. The device will reboot.

Troubleshooting

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

Last updated: Feb 18, 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

Troubleshooting

Related topics