# get-node > Download a specific version of Node.js Latest version **15.0.4** (published 2025-06-03) · Apache-2.0 license · 0 weekly downloads ## Install ```sh npm install get-node pnpm add get-node yarn add get-node bun add get-node ``` ## Health **Score 55/100 (C)** — status: stable. Positive: has types; esm support; no vulnerabilities; high maintenance score; high quality score. Warnings: low downloads. Negative: stale. ## Facts | | | |---|---| | Version | 15.0.4 | | Published | 2025-06-03 | | First published | 2019-08-08 | | Weekly downloads | 0 | | License | Apache-2.0 | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Node | >=18.18.0 | | Dependencies | 14 | | Unpacked size | 43.1 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 23 | | Author | ehmicky | | Maintainers | ehmicky | | Keywords | nodejs, node, download, nvm, npx, versions, versioning, exec, shell, terminal, command-line, cli, dependency-management, es6, javascript, typescript, library, npmjs, operating-system, package-manager | ## Links - npm: https://www.npmjs.com/package/get-node - Repository: https://github.com/ehmicky/get-node - Homepage: https://www.github.com/ehmicky/get-node - Issues: https://github.com/ehmicky/get-node/issues - npm.io page: https://npm.io/package/get-node ## Dependencies (14) - [execa](https://npm.io/package/execa.md) ^9.5.2 - [jszip](https://npm.io/package/jszip.md) ^3.10.1 - [semver](https://npm.io/package/semver.md) ^7.7.1 - [tar-fs](https://npm.io/package/tar-fs.md) ^3.0.9 - [memoize](https://npm.io/package/memoize.md) ^10.1.0 - [path-key](https://npm.io/package/path-key.md) ^4.0.0 - [move-file](https://npm.io/package/move-file.md) ^3.0.0 - [path-exists](https://npm.io/package/path-exists.md) ^5.0.0 - [tmp-promise](https://npm.io/package/tmp-promise.md) ^3.0.3 - [is-plain-obj](https://npm.io/package/is-plain-obj.md) ^4.1.0 - [global-cache-dir](https://npm.io/package/global-cache-dir.md) ^6.0.1 - [fetch-node-website](https://npm.io/package/fetch-node-website.md) ^9.0.1 - [node-version-alias](https://npm.io/package/node-version-alias.md) ^5.0.1 - [preferred-node-version](https://npm.io/package/preferred-node-version.md) ^5.0.1 ## Alternatives - [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads - [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads - [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads - [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads - [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads ## Recent versions - 15.0.4 (latest) — 2025-06-03 - 15.0.3 — 2025-03-29 - 15.0.2 — 2025-03-28 - 15.0.1 — 2024-05-10 - 15.0.0 — 2023-10-28 - 14.2.1 — 2023-08-19 - 14.2.0 — 2023-07-13 - 14.1.0 — 2023-07-13 - 14.0.0 — 2023-05-13 - 13.6.0 — 2023-02-11 - 13.5.0 — 2022-11-11 - 13.4.0 — 2022-10-18 - 13.3.0 — 2022-10-08 - 13.2.0 — 2022-08-16 - 13.1.0 — 2022-06-26 - … 53 more at https://npm.io/package/get-node/versions ## README [![Node](https://img.shields.io/badge/-Node.js-808080?logo=node.js&colorA=404040&logoColor=66cc33)](https://www.npmjs.com/package/get-node) [![TypeScript](https://img.shields.io/badge/-Typed-808080?logo=typescript&colorA=404040&logoColor=0096ff)](/src/main.d.ts) [![Codecov](https://img.shields.io/badge/-Tested%20100%25-808080?logo=codecov&colorA=404040)](https://codecov.io/gh/ehmicky/get-node) [![Mastodon](https://img.shields.io/badge/-Mastodon-808080.svg?logo=mastodon&colorA=404040&logoColor=9590F9)](https://fosstodon.org/@ehmicky) [![Medium](https://img.shields.io/badge/-Medium-808080.svg?logo=medium&colorA=404040)](https://medium.com/@ehmicky) Download a specific version of Node.js. The Node.js release is downloaded, uncompressed and untared to an executable file ready to run. # Features Fast: - the download is cached - the best compression algorithm available on your machine is used - everything is streamed Reliable: - the binary is checked against [official checksums](https://github.com/nodejs/node#verifying-binaries) - can be safely run concurrently - atomic writes Features include: - Linux/Mac/Windows support - works with old Node.js versions - [progress bar](#progress) - using [version ranges](#getnodeversionrange-options) - specifying [a mirror website](#mirror) for nodejs.org - helpful error messages - can guess the current project's version using its [`.nvmrc` or `package.json` (`engines.node` field)](#getnodeversionrange-options) # Example ```js import getNode from 'get-node' // Download a specific Node.js release const { path, version } = await getNode('8') console.log(path) // /home/user/.cache/nve/8.17.0/node console.log(version) // 8.17.0 ``` ```js // Download Node.js latest release const { path, version } = await getNode('latest') console.log(path) // /home/user/.cache/nve/16.3.0/node console.log(version) // 16.3.0 ``` ```js // Any version range can be used await getNode('8.12.0') await getNode('<7') ``` ```js // Download latest LTS Node.js version await getNode('lts') ``` ```js // Download Node.js version from `~/.nvmrc` or the current process version await getNode('global') ``` ```js // Download current directory's Node.js version using its `.nvmrc` or // `package.json` (`engines.node` field) await getNode('local') ``` ```js // Download Node.js version from a specific file like `.nvmrc` or `package.json` await getNode('/path/to/.nvmrc') ``` ```js // Specify the output directory const { path } = await getNode('8', { output: '/home/user/.cache/node_releases/', }) console.log(path) // /home/user/.cache/node_releases/13.0.1/node ``` ```js // Use a mirror website await getNode('8', { mirror: 'https://npmmirror.com/mirrors/node' }) ``` ```js // Specify the CPU architecture await getNode('8', { arch: 'x32' }) ``` # Install ```bash npm install get-node ``` `node >=18.18.0` must be globally installed. However any Node version can be downloaded. This package is an ES module and must be loaded using [an `import` or `import()` statement](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c), not `require()`. If TypeScript is used, it must be configured to [output ES modules](https://www.typescriptlang.org/docs/handbook/esm-node.html), not CommonJS. To use this module as a CLI instead, please check [`get-node-cli`](https://github.com/ehmicky/get-node-cli). # Usage ## getNode(versionRange, options?) `versionRange`: `string`\ `options`: `object?`\ _Return value_: `Promise` `versionRange` can be: - any [version range](https://github.com/npm/node-semver) such as `12`, `12.6.0` or `<12` - `latest`: Latest available Node version - `lts`: Latest LTS Node version - `global`: Global Node version - Using the home directory [`.nvmrc`](https://github.com/nvm-sh/nvm#nvmrc) or [`package.json` (`engines.node` field)](https://docs.npmjs.com/files/package.json#engines) - [Some similar files](https://github.com/ehmicky/preferred-node-version/blob/main/README.md) used by other Node.js version managers are also searched for - If nothing is found, defaults to the current process's Node version - `local`: Current directory's Node version - Using the current directory or parent directories [`.nvmrc`](https://github.com/nvm-sh/nvm#nvmrc), [`package.json` (`engines.node` field)](https://docs.npmjs.com/files/package.json#engines) or [similar files](https://github.com/ehmicky/preferred-node-version/blob/main/README.md) - Defaults to the `global` version - a file path towards a [`.nvmrc`](https://github.com/nvm-sh/nvm#nvmrc), [`package.json` (`engines.node` field)](https://docs.npmjs.com/files/package.json#engines) or [similar files](https://github.com/ehmicky/preferred-node-version/blob/main/README.md) ### Options #### output _Type_: `string`\ _Default_: [global cache directory](https://github.com/ehmicky/global-cache-dir) such as `/home/user/.cache/nve/`. Output directory for the `node` executable. It the directory already has a `node` executable, no download is performed. This enables caching. #### progress _Type_: `boolean`\ _Default_: `false` Whether to show a progress bar. #### mirror _Type_: `string`\ _Default_: `https://nodejs.org/dist` Base URL to retrieve Node.js binaries. Can be customized (for example `https://npmmirror.com/mirrors/node`). The following environment variables can also be used: `NODE_MIRROR`, `NVM_NODEJS_ORG_MIRROR`, `N_NODE_MIRROR` or `NODIST_NODE_MIRROR`. #### fetch _Type_: `boolean`\ _Default_: `undefined` The list of available Node.js versions is cached for one hour by default. If the `fetch` option is: - `true`: the cache will not be used - `false`: the cache will be used even if it's older than one hour #### arch _Type_: `string`\ _Default_: [`process.arch`](https://nodejs.org/api/process.html#process_process_arch) Node.js binary's CPU architecture. This is useful for example when you're on x64 but would like to run Node.js x32. All the values from [`process.arch`](https://nodejs.org/api/process.html#process_process_arch) are allowed except `mips` and `mipsel`. #### cwd _Type_: `string | URL`\ _Default_: `.` When using the [`local` alias](#getnodeversionrange-options), start looking for a Node.js version file from this directory. #### signal _Type_: [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) Cancels when the signal is aborted. ### Return value The returned `Promise` resolves to an object with the following properties. #### path _Type_: `string` Absolute path to the `node` executable. #### version _Type_: `string` [Normalized](https://github.com/ehmicky/normalize-node-version) Node.js version. # See also - [`get-node-cli`](https://github.com/ehmicky/get-node-cli): `get-node` as a CLI - [`nve`](https://github.com/ehmicky/nve): Run a specific Node.js version (CLI) - [`nvexeca`](https://github.com/ehmicky/nve): Run a specific Node.js version (programmatic) - [`preferred-node-version`](https://github.com/ehmicky/preferred-node-version): Get the preferred Node.js version of a project or user - [`node-version-alias`](https://github.com/ehmicky/node-version-alias): Resolve Node.js version aliases like `latest`, `lts` or `erbium` - [`normalize-node-version`](https://github.com/ehmicky/normalize-node-version): Normalize and validate Node.js versions - [`all-node-versions`](https://github.com/ehmicky/all-node-versions): List all available Node.js versions - [`fetch-node-website`](https://github.com/ehmicky/fetch-node-website): Fetch releases on nodejs.org - [`global-cache-dir`](https://github.com/ehmicky/global-cache-dir): Get the global cache directory # Support For any question, _don't hesitate_ to [submit an issue on GitHub](../../issues). Everyone is welcome regardless of personal background. We enforce a [Code of conduct](CODE_OF_CONDUCT.md) in order to promote a positive and inclusive environment. # Contributing This project was made with ❤️. The simplest way to give back is by starring and sharing it online. If the documentation is unclear or has a typo, please click on the page's `Edit` button (pencil icon) and suggest a correction. If you would like to help us fix a bug or add a new feature, please check our [guidelines](CONTRIBUTING.md). Pull requests are welcome! Thanks go to our wonderful contributors:

ehmicky
💻 🎨 🤔 📖
Charlike Mike Reagent
🐛
hiroki osame
💻 ⚠️ 🤔
--- _Source: https://npm.io/package/get-node · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._