Emberbird
Subsystem Doctor • Phase D1

Ember Doctor Diagnostic Analyzer

Verify system requirements, virtualization features, networking adapters, and storage health. Paste your Doctor CLI report or run diagnostic commands on your machine.

Run Diagnostics Locally

Execute Ember Doctor via Python or the built-in diagnostic tool in Emberbird Manager:

Inspect Host Environmentpython scripts/doctor.py
Elevated Safe Self-Healingpython scripts/doctor.py --fix

Interactive Doctor Report Analyzer

Paste the JSON output of python scripts/doctor.py --json to inspect probe results in the browser.

Diagnostic Probes Reference

12 diagnostic domains evaluated across BIOS, Windows features, ADB, and storage.

12 Active Probes
PRB-01Virtualization

Hardware Virtualization (VT-x / AMD-V)

Standard Fix:Enable 'Intel Virtualization Technology' (VT-x) or 'SVM Mode' (AMD-V) in BIOS/UEFI settings.
PRB-02Hyper-V

VirtualMachinePlatform Feature

Standard Fix:dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
PRB-03Hyper-V

HypervisorPlatform Feature

Standard Fix:dism.exe /online /enable-feature /featurename:HypervisorPlatform /all /norestart
PRB-04Windows

Windows Developer Mode

Standard Fix:reg add "HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" /t REG_DWORD /f /v "AllowDevelopmentWithoutDevLicense" /d 1
PRB-05Services

AppX Deployment Service (AppXSvc)

Standard Fix:net start AppXSvc
PRB-06Networking

ADB Loopback Binding (58526)

Standard Fix:Enable Developer Mode in WSA Settings and run 'adb connect 127.0.0.1:58526'.
PRB-07Storage

Virtual Disk Lock (userdata.vhdx)

Standard Fix:Terminate any orphaned WsaClient or vmcompute processes with 'taskkill /F /IM WsaClient.exe'.
PRB-08WSL

Host Compute Service & WSL (vmcompute)

Standard Fix:net start vmcompute
PRB-09Play Services

Google Play Services Registration

Standard Fix:Install an Emberbird WSA release bundled with GApps (WSA Standard Edition).
PRB-10Auth

Google Play Store Certification & Sign-In

Standard Fix:Register your device GSF ID at google.com/android/uncertified or clear Play Store cache.
PRB-11Networking

Virtual Network Adapter & Hyper-V Switch

Standard Fix:netsh winsock reset
PRB-12Storage

Disk Space & userdata.vhdx Health

Standard Fix:Ensure >= 25 GB free disk space on drive C: for dynamic VHDX expansion.
← Return to Interactive Troubleshooting WizardView Error Codes Reference →