Troubleshoot issues

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.

This section contains guides to help you resolve common issues you might encounter when developing for Vega.

Each guide provides detailed step-by-step instructions for diagnosing and resolving specific issues. If you can't find a solution to your problem in these guides, consider posting a question in the Developer Forums.

App development issues

App runtime issues

Learn how to resolve common runtime failures.

Issues when building apps with Vega Studio

This page addresses common issues when building apps with Vega Studio.

Development environment issues

SDK installation issues

Get help with common Vega SDK installation problems, including Python build issues, Homebrew installation troubles, and environment setup problems on both macOS and Linux platforms.

Vega extension and CLI issues

Resolve common problems with the Vega CLI and VS Code extension.

Fast Refresh issues

Find solutions to problems using Fast Refresh.

Device and VVD issues

Vega virtual device issues

Troubleshoot common VVD problems including startup failures, crashes, SSH connection issues, and registration problems.

Fire TV Stick issues

Find solutions for Fire TV Stick-specific problems including power issues, OTA update troubles, app installation problems, and device management tasks.

Vega Device Adapter (VDA) connection and power issues

Learn how to resolve VDA connection problems, handle permissions issues, and troubleshoot device detection problems across different operating systems.

Input issues

On-screen keyboard issues

Learn how to resolve issues with the on-screen keyboard availability in your Vega apps.

Other issues

Aggregated crash report (ACR) issues

This page provides resolution to common problems that can occur during ACR analysis and symbolication processes in Vega Studio.

Vega Live TV issues

Find resources for problems using Live TV for Vega.

Monorepo issues

This page covers common issues and solutions when working with a monorepo in Vega Studio.

Network Proxy issues

Find solutions to issues using Vega Studio's Network Proxy tool.

Last updated: Sep 30, 2025