Skip to content

Commit 91a3b88

Browse files
authored
Qualcomm + machine wide install troubleshooting. (#176)
* Qualcomm + machine wide install troubleshooting. * Update reference-troubleshooting.md
1 parent cc20b9d commit 91a3b88

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

docs/reference/reference-troubleshooting.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,9 @@
77
| Slow inference | CPU-only model on large parameter count | Use GPU-optimized model variants when available |
88
| Model download failures | Network connectivity issues | Check your internet connection, try `foundry cache list` to verify cache state |
99
| Service won't start | Port conflicts or permission issues | Try `foundry service restart` or post an issue providing logs with `foundry zip-logsrock` |
10-
10+
| Qualcomm NPU error (`Qnn error code 5005: "Failed to load from EpContext model. qnn_backend_manager."`) | Qualcomm NPU error | Under investigation |
11+
| `winget install Microsoft.FoundryLocal --scope machine` fails with “The current system configuration does not support the installation of this package.” | Winget blocks MSIX machine-scope installs due to an OS bug when using provisioning APIs from a packaged context | Use `Add-AppxProvisionedPackage` instead. Download the `.msix` and its dependency, then run in **elevated** PowerShell: `Add-AppxProvisionedPackage -Online -PackagePath .\FoundryLocal.msix -DependencyPackagePath .\VcLibs.appx -SkipLicense`. This installs Foundry Local for all users.|
12+
| QNN graph execute error (Error 6031) | NPU model issue | Under investigation. Try using a different model or the equivalent cpu model in the meantime. |
1113
## Diagnosing performance issues
1214

1315
If you're experiencing slow inference:

0 commit comments

Comments
 (0)