Skip to content

Conversation

@MikeMcC399
Copy link
Contributor

Fixes: #61690

Current situation

The BUILDING > Option 3: Automated install with Boxstarter document section includes instructions with an associated script to automatically install dependencies on Windows required to build Node.js.

These instructions are non-working: the script fails to install the necessary Visual Studio workload and optional components. Instead it reports an "Unhandled Exception".

Background

The last release of chocolatey/boxstarter was 3.0.3 in Oct 6, 2023. It is bundled with [email protected], not the current [email protected].

Boxstarter is only compatible with the legacy Windows PowerShell 5, not with PowerShell 7 (see issue chocolatey/boxstarter#353 from Oct 2018).

Given the outdated nature of the Boxstarter release, it seems unlikely that there will be a new release that solves the above issues.

Node.js history

The Boxstarter automated install script was introduced to Node.js in Nov 2017.

Later, in Sep 2024, a set of WinGet configuration scripts was added that offered an alternative to the Boxstarter script.

Change

Remove:

Alternatives

Dependencies for Windows builds can be installed by following the remaining instructions in the BUILDING > Windows prerequisites section:

@nodejs-github-bot
Copy link
Collaborator

Review requested:

  • @nodejs/actions
  • @nodejs/build
  • @nodejs/tsc

@nodejs-github-bot nodejs-github-bot added build Issues and PRs related to build files or the CI. doc Issues and PRs related to the documentations. meta Issues and PRs related to the general management of the project. tools Issues and PRs related to the tools directory. labels Feb 12, 2026
@MikeMcC399 MikeMcC399 marked this pull request as ready for review February 12, 2026 08:25
@richardlau richardlau added author ready PRs that have at least one approval, no pending requests for changes, and a CI started. commit-queue Add this label to land a pull request using GitHub Actions. labels Feb 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author ready PRs that have at least one approval, no pending requests for changes, and a CI started. build Issues and PRs related to build files or the CI. commit-queue Add this label to land a pull request using GitHub Actions. doc Issues and PRs related to the documentations. meta Issues and PRs related to the general management of the project. tools Issues and PRs related to the tools directory.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Boxstarter-based automated install fails with VS2022 workload

9 participants