Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/troubleshooting/error-codes.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ NVM for Windows uses stable `NVM####` codes in CLI messages, shim/proxy output,
|:-|:-|:-|
| **NVM4100** | Silent install rejected a custom program directory | Community Inno Setup runs with `/SILENT` or `/VERYSILENT` and a non-default `/DIR` (program root must stay under LocalAppData) |
| **NVM4101** | Community build running outside its trusted program root | Community `nvm.exe` (or doctor) detects the process is not under `%LOCALAPPDATA%\Author Software\nvm`; advisory warning, not a hard block |
| **NVM4116** | Community Inno refused a machine-triggered install | Setup ran as `NT AUTHORITY\SYSTEM`, a Microsoft fleet host was in the process ancestor chain (Intune IME, AgentExecutor, Task Scheduler, Group Policy script, or Configuration Manager), or a silent install had no real console and no Microsoft Store ancestor. Per-user LocalAppData only. Typed WinGet, Microsoft Store, and a double-click of the EXE are not this code. Setup writes Application event 4116 and logs the trigger. |
| **NVM4301** | Node.js integrity verification failed | Shim or node launcher refuses to run `node.exe` because Authenticode / trust checks failed; reinstall with `nvm install <ver> --force` is the usual recovery |
| **NVM4302** | Link-mode activation blocked | `nvm use` (link mode) rejects a version directory that is unsafe (for example writable by other users or a reparse point) or whose `node.exe` cannot be verified |
| **NVM4303** | Verify-cache state changed | Trusted verify-cache material for a Node binary no longer matches; NVM requires a full verification pass before trusting the binary again |
Expand Down Expand Up @@ -45,6 +46,7 @@ NVM for Windows uses stable `NVM####` codes in CLI messages, shim/proxy output,
## Tips

- Codes appear in user-facing text as `Event code: NVM####` and may also be logged to the Windows Application log or NVM operational channels (edition-dependent).
- **NVM4116** means setup refused to start. Community Inno blocked a machine-triggered install. Use Certified Builds for Intune, MSI, or IT-managed deployment. For a personal install, use a community installer from the docs. The Application log records event 4116 and the trigger.
- **NVM4304** is success/recovery telemetry, not a failure.
- **NVM4406** is an audit/info event for untrusted-module changes (including when allow/prompt accepts the change), not a failure. Structured payload includes `path`, `before_digest` / `after_digest` (SHA-256 hex when available), and `before_size` / `after_size`.
- **NVM4407** and **NVM4408** are audit/info events for module-firewall allow paths (remote HTTPS policy vs local/remote install evaluation), not failures.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ NVM for Windows использует стабильные коды `NVM####` в
|:-|:-|:-|
| **NVM4100** | Тихая установка отклонила нестандартный каталог программы | Community Inno Setup с `/SILENT` или `/VERYSILENT` и нестандартным `/DIR` (корень программы должен оставаться под LocalAppData) |
| **NVM4101** | Community-сборка запущена вне доверенного корня программы | Community `nvm.exe` (или doctor) видит процесс не под `%LOCALAPPDATA%\Author Software\nvm`; предупреждение, не жёсткая блокировка |
| **NVM4116** | Community Inno отказал в машинной установке | Установщик запущен как `NT AUTHORITY\SYSTEM`, в цепочке предков есть хост Microsoft fleet (Intune IME, AgentExecutor, Task Scheduler, скрипт Group Policy или Configuration Manager), либо тихая установка без настоящей консоли и без предка Microsoft Store. Только per-user LocalAppData. Обычный WinGet из терминала, Microsoft Store и двойной щелчок по EXE — не этот код. В Application log пишется событие 4116 и триггер. |
| **NVM4301** | Проверка целостности Node.js не прошла | Shim или node launcher отказывается запускать `node.exe` из‑за сбоя Authenticode / trust; обычно помогает `nvm install <ver> --force` |
| **NVM4302** | Блокировка активации в режиме link | `nvm use` (link) отклоняет небезопасный каталог версии (например, доступен другим пользователям на запись или reparse point) либо непроверенный `node.exe` |
| **NVM4303** | Изменилось состояние verify-cache | Материал trusted verify-cache для Node-бинарника больше не совпадает; нужна полная повторная проверка |
Expand Down Expand Up @@ -40,6 +41,7 @@ NVM for Windows использует стабильные коды `NVM####` в
## Подсказки

- Коды встречаются в тексте как `Event code: NVM####` и могут попадать в Application log или operational-каналы NVM (зависит от edition).
- **NVM4116** означает, что установка не началась. Community Inno заблокировал машинную установку. Для Intune, MSI и IT-managed используйте Certified Builds. Для личной установки используйте community-установщик из документации. В Application log — событие 4116 и триггер.
- **NVM4304** — успешное/восстановительное событие, не ошибка.
- **NVM4406** — audit/info о смене недоверенного модуля (в т.ч. при allow или accept prompt), не ошибка.
- **NVM4407** и **NVM4408** — audit/info о разрешённых module-firewall install (remote HTTPS vs локальная/remote оценка), не ошибки.
Expand Down
Loading