Resolve Fire TV Stick Issues - Amazon Vega Docs

This page helps you resolve common issues specific to Fire TV Stick devices when developing with the Vega SDK. If you don’t find a solution to your specific problem here, post an issue in the Developer Forum for additional support.

Fire TV Stick constantly reboots after an over-the-air (OTA) update

Cause: Unsupported developer mode value set while using the KPI Visualizer causes boot loops after OTA updates. Solution: Disable developer mode using one of these commands:

vega exec vda wait-for-device && vega exec vda shell vsm developer-mode disable

Or:

vega exec vda wait-for-device && vega exec vda shell vdcm set com.amazon.devconf/system/security/developer_mode disable

After running the command, the device should stop rebooting and function normally.

Fire TV Stick restarts when powered through computer USB

Cause: Insufficient power supply from laptop USB ports. The device requires up to one Amp at 5V, which many laptop USB ports can’t provide during high CPU usage like streaming or weak Wi-Fi. Solution: Use one of these options: Option 1: Use a USB Y-Cable Connect the Fire TV Stick using a USB Y-Cable to draw power from both your laptop’s USB port and the Amazon-provided USB power adapter. Option 2: Use a powered USB hub Connect the Fire TV Stick through an independently powered USB 3.0 hub capable of providing one Amp or more.

Fire TV Stick didn’t receive OTA update

Cause: Device lacks Wi-Fi connection or requires manual update trigger. Solution:

Open a VDA shell:
vega exec vda shell
Check your device network connection:
ace mw wifi_cli get_net_state
The command should return networkState: CONNECTED. If your device fails to connect, see Fire TV Stick.

Force a manual update:

vega exec vda shell ace mw ota forceUpdate

OTA update verification fails

Cause: The system can’t verify that the OTA update completed successfully or matches the expected SDK version. Solution:

Check the device’s os-release version:
vega exec vda shell cat /etc/os-release | grep VERSION_NUMBER
Replace VERSION_NUMBER with your device’s release version number.
Verify the returned version number matches the latest SDK version.

The device needs factory reset

Cause: System corruption or persistent configuration issues prevent the device from functioning properly. Solution: Run the factory reset command:

vega exec vda shell vfr reset --type shallow

The app becomes unresponsive

Cause: The app enters an error state that prevents normal operation. Solution:

Open a VDA shell:
vega exec vda shell

List running apps:

vlcm list

Sample output:

application                           type      pid     id    state          lifespan       timeout container                               launch args
com.amazondeveloper.sampleapp.main       S         2719    1     VISIBLE        PERMANENT      DEFAULT framework.slice/service                 <none>

Terminate the app using its package name: Example: vlcm terminate-app --pkg-id com.amazondeveloper.sampleapp

Uninstall the app from a device

Cause: App removal required for testing or cleanup purposes. Solution: Run the uninstall command:

vpm uninstall <packageId>

Replace <packageId> with your app’s package ID (for example: com.foo.sampleapp)

Move the app between background and foreground

Cause: Testing or debugging requires changing the app state between background and foreground. Solution: To move the app to background:

vlcm trigger-app background --inst <instance-id>

Replace <instance-id> with the one for your app. To move the app to foreground:

vlcm trigger-app foreground --inst <instance-id>

Replace <instance-id> with the one for your app.

Run Your App on Fire TV Stick

​Fire TV Stick constantly reboots after an over-the-air (OTA) update

​Fire TV Stick restarts when powered through computer USB

​Fire TV Stick didn’t receive OTA update

​OTA update verification fails

​The device needs factory reset

​The app becomes unresponsive

​Uninstall the app from a device

​Move the app between background and foreground

​Related topics