node-build is a command-line utility that makes it easy to install virtually any version of Node, from source or precompiled binary.
It is available as a plugin for nodenv that
provides the nodenv install
command, or as a standalone program.
# Using Homebrew on macOS
$ brew install node-build
# As a nodenv plugin
$ mkdir -p "$(nodenv root)"/plugins
$ git clone https://github.com/nodenv/node-build.git "$(nodenv root)"/plugins/node-build
# As a standalone program
$ git clone https://github.com/nodenv/node-build.git
$ PREFIX=/usr/local ./node-build/install.sh
# Via Homebrew
$ brew update && brew upgrade node-build
# As a nodenv plugin
$ cd "$(nodenv root)"/plugins/node-build && git pull
To grab the latest versions from nodejs.org and generate definition files for node-build to use, check out the node-build-update-defs plugin. Once installed:
nodenv update-version-defs
No need to wait for node-build to provide the latest definitions!
# As a nodenv plugin
$ nodenv install --list # lists all available versions of Node
$ nodenv install 10.13.0 # installs Node 10.13.0 to ~/.nodenv/versions
# As a standalone program
$ node-build --definitions # lists all available versions of Node
$ node-build 10.13.0 ~/local/node-10.13.0 # installs Node 10.13.0 to ~/local/node-10.13.0
node-build does not check for system dependencies before downloading and attempting to compile the Node source. Please ensure that all requisite libraries are available on your system.
By default, node-build will attempt to match one of the precompiled binaries
to your platform. If there is a binary for your platform, it will install it
instead of compiling from source. To force compilation, pass the -c
or
--compile
flag.
If you wish to develop and install a version of Node that is not yet supported by node-build, you may specify the path to a custom “build definition file” in place of a Node version number.
Use the default build definitions as a template for your custom definitions.
The build process may be configured through the following environment variables:
Variable | Function |
---|---|
TMPDIR |
Where temporary files are stored. |
NODE_BUILD_BUILD_PATH |
Where sources are downloaded and built. (Default: a timestamped subdirectory of TMPDIR ) |
NODE_BUILD_CACHE_PATH |
Where to cache downloaded package files. (Default: ~/.nodenv/cache if invoked as nodenv plugin) |
NODE_BUILD_HTTP_CLIENT |
One of aria2c , curl , or wget to use for downloading. (Default: first one found in PATH) |
NODE_BUILD_ARIA2_OPTS |
Additional options to pass to aria2c for downloading. |
NODE_BUILD_CURL_OPTS |
Additional options to pass to curl for downloading. |
NODE_BUILD_WGET_OPTS |
Additional options to pass to wget for downloading. |
NODE_BUILD_MIRROR_CMD |
A command to construct the package mirror URL. |
NODE_BUILD_MIRROR_URL |
Custom mirror URL root. |
NODE_BUILD_SKIP_MIRROR |
Always download from official sources, not mirrors. (Default: unset) |
NODE_BUILD_ROOT |
Custom build definition directory. (Default: share/node-build ) |
NODE_BUILD_DEFINITIONS |
Additional paths to search for build definitions. (Colon-separated list) |
CC |
Path to the C compiler. |
NODE_CFLAGS |
Additional CFLAGS options (e.g., to override -O3 ). |
CONFIGURE_OPTS |
Additional ./configure options. |
MAKE |
Custom make command (e.g., gmake ). |
MAKE_OPTS / MAKEOPTS |
Additional make options. |
MAKE_INSTALL_OPTS |
Additional make install options. |
NODE_CONFIGURE_OPTS |
Additional ./configure options (applies only to Node source). |
NODE_MAKE_OPTS |
Additional make options (applies only to Node source). |
NODE_MAKE_INSTALL_OPTS |
Additional make install options (applies only to Node source). |
Both nodenv install
and node-build
support the --patch
(-p
) flag to apply
a patch to the Node (/iojs/chakracore) source code before building.
Patches are read from STDIN
:
# applying a single patch
$ nodenv install --patch 11.1.0 < /path/to/node.patch
# applying a patch from HTTP
$ nodenv install --patch 11.1.0 < <(curl -sSL http://git.io/node.patch)
# applying multiple patches
$ cat fix1.patch fix2.patch | nodenv install --patch 11.1.0
If you have the shasum
, openssl
, or sha256sum
tool installed, node-build will
automatically verify the SHA2 checksum of each downloaded package before
installing it.
Checksums are optional and specified as anchors on the package URL in each definition. (All bundled definitions include checksums.)
By default, node-build downloads package files from the official URL specified in the definition file.
You can point node-build to a mirror by specifying the
NODE_BUILD_MIRROR_URL
environment variable--useful if you'd like to run your
own local mirror, for example. Package mirror URLs are constructed by invoking
NODE_BUILD_MIRROR_CMD
with two arguments: package_url
and checksum
. The
provided command should print the desired mirror's package URL. If
NODE_BUILD_MIRROR_CMD
is unset, package mirror URL construction defaults to
simply replacing https://nodejs.org/dist
with NODE_BUILD_MIRROR_URL
.
If you don't have an SHA2 program installed, node-build will skip the download
mirror and use official URLs instead. You can force node-build to bypass the
mirror by setting the NODE_BUILD_SKIP_MIRROR
environment variable.
Both node-build
and nodenv install
accept the -k
or --keep
flag, which
tells node-build to keep the downloaded source after installation. This can be
useful if you need to use gdb
and memprof
with Node.
Source code will be kept in a parallel directory tree $(nodenv root)/sources
when using --keep
with the nodenv install
command. You should specify the
location of the source code with the NODE_BUILD_BUILD_PATH
environment
variable when using --keep
with node-build
.
The nodenv-install plugin can attempt a retry if the installation failed due
to a missing definition file. If the given node version name begins with
'v', 'node', or 'node-v', the retry will drop the prefix and try again. For
instance, if nodenv install node-v11.0.0
fails because a definition file
does not exist by the name "node-v11.0.0", it will retry as "11.0.0".
For this retry to be attempted, the environment variable NODENV_PREFIX_RETRY
must be non-empty.
Please see the node-build wiki for solutions to common problems. Also, check out the ruby-build wiki.
If you can't find an answer on the wiki, open an issue on the issue tracker. Be sure to include the full build log for build failures.
Forked from Sam Stephenson's ruby-build by Will McKenzie and modified for node.