Browse files

tools: add Boxstarter script

Adds a Boxstarter script for easy Node.js building prerequisites installation

PR-URL: #17046
Reviewed-By: Benjamin Gruenbaum <>
Reviewed-By: Refael Ackermann <>
Reviewed-By: João Reis <>
Reviewed-By: Gibson Fahnestock <>
  • Loading branch information...
bzoz authored and gibfahn committed Nov 14, 2017
1 parent 0ff82b5 commit 57d2a1ed4cb7edbc27096c0a53e3c500678a537a
Showing with 79 additions and 0 deletions.
  1. +3 −0
  2. +55 −0 tools/bootstrap/
  3. +21 −0 tools/bootstrap/windows_boxstarter
@@ -90,6 +90,9 @@ Depending on host platform, the selection of toolchains may vary.
## Building Node.js on supported platforms
*Note:* All prerequisites can be easily installed by following
[this bootstrapping guide](
### Unix / macOS
@@ -0,0 +1,55 @@
# Node.js Bootstrapping Guide
## Windows
A [Boxstarter][] script can be used for easy setup of Windows systems with all
the required prerequisites for Node.js development. This script will install
the following [Chocolatey] packages:
* [Git for Windows][] with the `git` and Unix tools added to the `PATH`
* [Python 2.x][]
* [Visual Studio 2017 Build Tools][] with [Visual C++ workload][]
To install Node.js prerequisites using [Boxstarter WebLauncher][], just open
[this link](
with Internet Explorer or Edge browser on the target machine.
Alternatively, you can use PowerShell. Run those commands from an elevated
PowerShell terminal:
Set-ExecutionPolicy Unrestricted -Force
iex ((New-Object System.Net.WebClient).DownloadString(''))
get-boxstarter -Force
Install-BoxstarterPackage -DisableReboots
Entire installation will take up about 8 GB of disk space.
## Linux
For building Node.js on Linux, following packages are required (note, that this
can vary from distribution to distribution):
* `git`
* `python`
* `gcc-c++` or `g++`
* `make`
To bootstrap Node.js on Linux, run in terminal:
* OpenSUSE: `sudo zypper install git python gcc-c++ make`
* Fedora: `sudo dnf install git python gcc-c++ make`
* Ubuntu, Debian: `sudo apt-get install git python g++ make`
## macOS
To install required tools on macOS, run in terminal:
xcode-select --install
[Boxstarter WebLauncher]:
[Git for Windows]:
[Python 2.x]:
[Visual Studio 2017 Build Tools]:
[Visual C++ workload]:
@@ -0,0 +1,21 @@
# Boxstarter ( script for Node.js prerequisites
# To install either open this link in IE or Edge:
# Or run those commands in an elevated Powershell terminal:
# iex ((New-Object System.Net.WebClient).DownloadString(''))
# get-boxstarter -Force
# Install-BoxstarterPackage -DisableReboots
# For more detail see
# Git and Unix tools will be added to the PATH
choco install git -params /GitAndUnixToolsOnPath -y
choco install python2 -y
# Installs VS 2017 Build Tools
choco install visualstudio2017buildtools -y
choco install visualstudio2017-workload-vctools -y

0 comments on commit 57d2a1e

Please sign in to comment.