Node.js

Node.js JavaScript runtime

README

Node.js


Node.js is an open-source, cross-platform JavaScript runtime environment.

For information on using Node.js, see the [Node.js website][].

The Node.js project uses an open governance model. The
[OpenJS Foundation][] provides support for the project.

This project has a [Code of Conduct][].

Table of contents



Support


Looking for help? Check out the

Release types


Current: Under active development. Code for the Current release is in the
  branch for its major version number (for example,
  v15.x). Node.js releases a new
  major version every 6 months, allowing for breaking changes. This happens in
  April and October every year. Releases appearing each October have a support
  life of 8 months. Releases appearing each April convert to LTS (see below)
  each October.
LTS: Releases that receive Long Term Support, with a focus on stability
  and security. Every even-numbered major version will become an LTS release.
  LTS releases receive 12 months of _Active LTS_ support and a further 18 months
  of _Maintenance_. LTS release lines have alphabetically-ordered code names,
  beginning with v4 Argon. There are no breaking changes or feature additions,
  except in some special circumstances.
Nightly: Code from the Current branch built every 24-hours when there are
  changes. Use with caution.

Current and LTS releases follow semantic versioning. A
member of the Release Team signs each Current and LTS release.
For more information, see the

Download


Binaries, installers, and source tarballs are available at
.

Current and LTS releases



The latest directory is an
alias for the latest Current release. The latest-_codename_ directory is an
alias for the latest release from an LTS line. For example, the
latest-fermium directory
contains the latest Fermium (Node.js 14) release.

Nightly releases



Each directory name and filename contains a date (in UTC) and the commit
SHA at the HEAD of the release.

API documentation


Documentation for the latest Current release is at .
Version-specific documentation is available in each release directory in the
_docs_ subdirectory. Version-specific documentation is also at
.

Verifying binaries


Download directories contain a SHASUMS256.txt file with SHA checksums for the
files.

To download SHASUMS256.txt using curl:

  1. ```console
  2. $ curl -O https://nodejs.org/dist/vx.y.z/SHASUMS256.txt
  3. ```

To check that a downloaded file matches the checksum, run
it through sha256sum with a command such as:

  1. ```console
  2. $ grep node-vx.y.z.tar.gz SHASUMS256.txt | sha256sum -c -
  3. ```

For Current and LTS, the GPG detached signature of SHASUMS256.txt is in
SHASUMS256.txt.sig. You can use it with gpg to verify the integrity of
SHASUMS256.txt. You will first need to import
import the keys:

  1. ```console
  2. $ gpg --keyserver hkps://keys.openpgp.org --recv-keys 4ED778F539E3634C779C87C6D7062848A1AB005C
  3. ```

See Release keys for a script to import active release keys.

Next, download the SHASUMS256.txt.sig for the release:

  1. ```console
  2. $ curl -O https://nodejs.org/dist/vx.y.z/SHASUMS256.txt.sig
  3. ```

Then use gpg --verify SHASUMS256.txt.sig SHASUMS256.txt to verify
the file's signature.

Building Node.js


See BUILDING.md for instructions on how to build Node.js from
source and a list of supported platforms.

Security


For information on reporting security vulnerabilities in Node.js, see

Contributing to Node.js


[Contributing to the project][]
[Working Groups][]
[Strategic initiatives][]
[Technical values and prioritization][]

Current project team members


For information about the governance of the Node.js project, see

<!-- node-core-utils and find-inactive-tsc.mjs depend on the format of the TSC
     list. If the format changes, those utilities need to be tested and
     updated. -->

TSC (Technical Steering Committee)



**Antoine du Hamel** <> (he/him) **Anatoli Papirovski** <> (he/him) **Beth Griggs** <> (she/her) **Ruben Bridgewater** <> (he/him) **Сковорода Никита Андреевич** <> (he/him) **Colin Ihrig** <> (he/him) **Danielle Adams** <> (she/her) **Franziska Hinkelmann** <> (she/her) **Geoffrey Booth** <> (he/him) **Gireesh Punathil** <> (he/him) **James M Snell** <> (he/him) **Joyee Cheung** <> (she/her) **Chengzhong Wu** <> (he/him) **Matteo Collina** <> (he/him) **Michael Dawson** <> (he/him) **Darshan Sen** <> (he/him) **Richard Lau** <> **Robert Nagy** <> **Michaël Zasso** <> (he/him) **Tobias Nießen** <> (he/him) **Rich Trott** <> (he/him)

Emeriti

TSC emeriti


**Anna Henningsen** <> (she/her) **Ben Noordhuis** <> **Chris Dickinson** <> **Shelley Vohr** <> (she/her) **Daniel Bevenius** <> (he/him) **Evan Lucas** <> (he/him) **Jeremiah Senkpiel** <> (he/they) **Gabriel Schulhof** <> **Gibson Fahnestock** <> (he/him) **Fedor Indutny** <> **Isaac Z. Schlueter** <> **Josh Gavant** <> **Mary Marchini** <> (she/her) **Brian White** <> **Myles Borins** <> (he/him) **Bryan Hughes** <> **Ali Ijaz Sheikh** <> (he/him) **Alexis Campailla** <> **Bert Belder** <> **Rod Vagg** <> **Sam Roberts** <> **Shigeki Ohtsu** <> (he/him) **Sakthipriyan Vairamani** <> (he/him) **Tiancheng "Timothy" Gu** <> (he/him) **Trevor Norris** <>
<!-- node-core-utils and find-inactive-collaborators.mjs depend on the format
     of the collaborator list. If the format changes, those utilities need to be
     tested and updated. -->

Collaborators


**Anna Henningsen** <> (she/her) **Antoine du Hamel** <> (he/him) **Yagiz Nizipli** <> (he/him) **Anto Aravinth** <> (he/him) **Anatoli Papirovski** <> (he/him) **Ash Cripps** <> **Qingyu Deng** <> **Ben Coe** <> (he/him) **Bryan English** <> (he/him) **Benjamin Gruenbaum** <> **Beth Griggs** <> (she/her) **Bradley Farias** <>
bnb -
**Tierney Cyren** <> (they/he) **Ben Noordhuis** <> **Ruben Bridgewater** <> (he/him) **Christian Clauss** <> (he/him) **Сковорода Никита Андреевич** <> (he/him) **Colin Ihrig** <> (he/him) **Shelley Vohr** <> (she/her) **Kohei Ueno** <> (he/him) **Daeyeon Jeong** <> (he/him) **Daniel Bevenius** <> (he/him) **Danielle Adams** <> (she/her) **David Carlier** <> **Gus Caplan** <> (they/them) **Adrian Estrada** <> (he/him) **Erick Wendel** <> (he/him) **Evan Lucas** <> (he/him) **Franziska Hinkelmann** <> (she/her) **Feng Yu** <> (he/him) **Gerhard Stöbich** <> (he/they) **Gabriel Schulhof** <> **Jiawen Geng** <> **Geoffrey Booth** <> (he/him) **Gireesh Punathil** <> (he/him) **Guy Bedford** <> (he/him) **Harshitha K P** <> (she/her) **Zeyu "Alex" Yang** <> (he/him) **Ian Sutherland** <> **Fedor Indutny** <> **Jackson Tian** <> **Jacob Smith** <> (he/him) **James M Snell** <> (he/him) **Jan Krems** <> (he/him) **Joe Sepi** <> (he/him) **Joyee Cheung** <> (she/her) **Juan José Arboleda** <> (he/him) **Minwoo Jung** <> (he/him) **Yoshiki Kurihara** <> (he/him) **Chengzhong Wu** <> (he/him) **Shingo Inoue** <> (he/him) **Nitzan Uziely** <> **LiviaMedeiros** <> **Luigi Pinca** <> (he/him) **Luke Karrys** <> (he/him) **Zijian Liu** <> (he/him) **Akhil Marsonya** <> (he/him) **Matteo Collina** <> (he/him) **Xuguang Mei** <> (he/him) **Mestery** <> (he/him) **Michael Dawson** <> (he/him) **Milad Fa** <> (he/him) **Alba Mendez** <> (she/her) **Moshe Atlow** <> (he/him) **Brian White** <> **Myles Borins** <> (he/him) **Ouyang Yadong** <> (he/him) **Filip Skokan** <> **Andrey Pechkurov** <> (he/him) **Stephen Belanger** <> (he/him) **Rafael Gonzaga** <> (he/him) **Darshan Sen** <> (he/him) **Richard Lau** <> **Ricky Zhou** <<0x19951125@gmail.com>> (he/him) **Robert Nagy** <> **Ruy Adorno** <> (he/him) **Rod Vagg** <> **Ujjwal Sharma** <> (he/him) **Santiago Gimeno** <> **Masashi Hirano** <> (he/him) **Paolo Insogna** <> (he/him) **Steven R Loomis** <> **Weijia Wang** <>
sxa -
**Stewart X Addison** <> (he/him) **Michaël Zasso** <> (he/him) **theanarkh** <> (he/him) **Tiancheng "Timothy" Gu** <> (he/him) **Tobias Nießen** <> (he/him) **Trivikram Kamat** <> **Rich Trott** <> (he/him) **Vladimir de Turckheim** <> (he/him) **Mohammed Keyvanzadeh** <> (he/him) **Daijiro Wachi** <> (he/him) **Khaidi Chu** <> (he/him) **Yash Ladha** <> (he/him) **Yongsheng Zhang** <> (he/him)

Emeriti
<!-- find-inactive-collaborators.mjs depends on the format of the emeriti list.
     If the format changes, those utilities need to be tested and updated. -->

Collaborator emeriti


**Aleksei Koziatinskii** <> **Andras** <> **Anna M. Kedzierska** <> **Andreas Madsen** <> (he/him) **Alexey Orlenko** <> (he/him) **Benedikt Meurer** <> **Christopher Hiller** <> (he/him) **Brendan Ashworth** <> **Bartosz Sosnowski** <> **Calvin Metcalf** <> **Chris Dickinson** <> **Claudio Rodriguez** <> **David Cai** <> (he/him) **Jamie Davis** <> (he/him) **Hitesh Kanwathirtha** <> (he/him) **Xu Meng** <> (he/him) **dnlup** <> **Robert Jefe Lindstaedt** <> **Alexander Makarenko** <> **Eugene Ostroukhov** <> **Daniel Wang** <> **Jeremiah Senkpiel** <> (he/they) **George Adams** <> (he/him) **Wyatt Preul** <> **Gibson Fahnestock** <> (he/him) **Glen Keane** <> (he/him) **Yang Guo** <> (he/him) **Yuta Hiroto** <> (he/him) **Rebecca Turner** <> **Imran Iqbal** <> **Ilkka Myller** <> **Isaac Z. Schlueter** <> **Italo A. Casas** <> (he/him) **Jason Ginchereau** <> **Johan Bergström** <> **John-David Dalton** <> **Yuval Brik** <> **João Reis** <> **Josh Gavant** <> **Julian Duque** <> (he/him) **Kyle Farnung** <> (he/him) **Kunal Pathak** <> **Lance Ball** <> (he/him) **Luca Maraschi** <> (he/him) **Denys Otrishko** <> (he/him)
lxe -
**Aleksey Smolenchuk** <> **Jon Moss** <> (he/him) **Mathias Buus** <> (he/him) **Matthew Loring** <> **Nicu Micleușanu** <> (he/him) **Mikeal Rogers** <> **Julien Gilli** <> **Mary Marchini** <> (she/her) **Christopher Monsanto** <> **Chen Gang** <> **Teddy Katz** <> (he/him) **Ali Ijaz Sheikh** <> (he/him) **Oleg Elifantiev** <> **Alexis Campailla** <> **Forrest L Norvell** <> (they/them/themself) **Petka Antonov** <> **Phillip Johnsen** <> **Bert Belder** <> **Minqi Pan** <> **Pooja D P** <> (she/her) **Prince John Wesley** <> **Peter Marshall** <> (he/him) **Refael Ackermann (רפאל פלחי)** <> (he/him/הוא/אתה) **Pranshu Srivastava** <> (he/him) **Alex Kocharin** <>
rmg -
**Ryan Graham** <> **Robert Kowalski** <> **Roman Klauke** <> **Ron Korving** <> **Ingvar Stepanyan** <> **Sam Ruby** <> **Saúl Ibarra Corretgé** <> **Sam Roberts** <> **Sebastiaan Deckers** <> **Nikolai Vavilov** <> **Shigeki Ohtsu** <> (he/him) **Roman Reiss** <> **Stefan Budeanu** <> **Christian Tellnes** <> **Sakthipriyan Vairamani** <> (he/him) **Thorsten Lorenz** <> **Trevor Norris** <> **Mike Tunnicliffe** <> **Vladimir Kurchatkin** <> **Vse Mozhet Byt** <> (he/him) **Thomas Watson** <> **Jeremy Whitlock** <> **Yihong Wang** <> **Yorkie Liu** <> **Yosuke Furukawa** <>

Collaborators follow the Collaborator Guide in
maintaining the Node.js project.

Triagers


**Qingyu Deng** <> **Brian Muenzenmeyer** <> (he/him) **Daeyeon Jeong** <> (he/him) **Feng Yu** <> (he/him) **Himadri Ganguly** <> (he/him) **Frank Qiu** <> (he/him) **Keyhan Vakil** <> (they/them) **Akhil Marsonya** <> (he/him) **Xuguang Mei** <> (he/him) **Mestery** <> (he/him) **Moshe Atlow** <> (he/him) **Pooja Durgad** <> **Darshan Sen** <> **Mohammed Keyvanzadeh** <> (he/him)

Triagers follow the Triage Guide when
responding to new issues.

Release keys


Primary GPG keys for Node.js Releasers (some Releasers sign with subkeys):

* **Beth Griggs** <>
  4ED778F539E3634C779C87C6D7062848A1AB005C
* **Bryan English** <>
  141F07595B7B3FFE74309A937405533BE57C7D57
* **Danielle Adams** <>
  74F12602B6F1C4E913FAA37AD3A89613643B6201
* **Juan José Arboleda** <>
  61FC681DFB92A079F1685E77973F295594EC4689
* **Michaël Zasso** <>
  8FCCA13FEF1D0C2E91008E09770F7A9A5AE15600
* **Myles Borins** <>
  C4F0DFFF4E8C1A8236409D08E73BC641CC11F4C8
* **RafaelGSS** <>
  890C08DB8579162FEE0DF9DB8BEAB4DFCF555EF4
* **Richard Lau** <>
  C82FA3AE1CBEDC6BE46B9360C43CEC45C17AB93C
* **Ruy Adorno** <>
  108F52B48DB57BB0CC439B2997B01419BD92F80A

To import the full set of trusted release keys (including subkeys possibly used
to sign releases):

  1. ``` sh
  2. gpg --keyserver hkps://keys.openpgp.org --recv-keys 4ED778F539E3634C779C87C6D7062848A1AB005C
  3. gpg --keyserver hkps://keys.openpgp.org --recv-keys 141F07595B7B3FFE74309A937405533BE57C7D57
  4. gpg --keyserver hkps://keys.openpgp.org --recv-keys 74F12602B6F1C4E913FAA37AD3A89613643B6201
  5. gpg --keyserver hkps://keys.openpgp.org --recv-keys 61FC681DFB92A079F1685E77973F295594EC4689
  6. gpg --keyserver hkps://keys.openpgp.org --recv-keys 8FCCA13FEF1D0C2E91008E09770F7A9A5AE15600
  7. gpg --keyserver hkps://keys.openpgp.org --recv-keys C4F0DFFF4E8C1A8236409D08E73BC641CC11F4C8
  8. gpg --keyserver hkps://keys.openpgp.org --recv-keys 890C08DB8579162FEE0DF9DB8BEAB4DFCF555EF4
  9. gpg --keyserver hkps://keys.openpgp.org --recv-keys C82FA3AE1CBEDC6BE46B9360C43CEC45C17AB93C
  10. gpg --keyserver hkps://keys.openpgp.org --recv-keys 108F52B48DB57BB0CC439B2997B01419BD92F80A
  11. ```

See Verifying binaries for how to use these keys to
verify a downloaded file.

Other keys used to sign some previous releases

* **Chris Dickinson** <>
  9554F04D7259F04124DE6B476D5A82AC7E37093B
* **Colin Ihrig** <>
  94AE36675C464D64BAFA68DD7434390BDBE9B9C5
* **Danielle Adams** <>
  1C050899334244A8AF75E53792EF661D867B9DFA
* **Evan Lucas** <>
  B9AE9905FFD7803F25714661B63B535A4C206CA9
* **Gibson Fahnestock** <>
  77984A986EBC2AA786BC0F66B01FBB92821C587A
* **Isaac Z. Schlueter** <>
  93C7E9E91B49E432C2F75674B0A78B0A6C481CF6
* **Italo A. Casas** <>
  56730D5401028683275BD23C23EFEFE93C4CFFFE
* **James M Snell** <>
  71DCFD284A79C3B38668286BC97EC7A07EDE3FC1
* **Jeremiah Senkpiel** <>
  FD3A5288F042B6850C66B31F09FE44734EB7990E
* **Julien Gilli** <>
  114F43EE0176B71C7BC219DD50A3051F888C628D
* **Rod Vagg** <>
  DD8F2338BAE7501E3DD5AC78C273792F7D83545D
* **Ruben Bridgewater** <>
  A48C2BEE680E841632CD4E44F07496B3EB3C1762
* **Shelley Vohr** <>
  B9E2F5981AA6E0CD28160D9FF13993A75599653C
* **Timothy J Fontaine** <>
  7937DFD2AB06298B2293C3187D33FF9D0246406D


Security release stewards


When possible, the commitment to take slots in the
security release steward rotation is made by companies in order
to ensure individuals who act as security stewards have the
support and recognition from their employer to be able to
prioritize security releases. Security release stewards manage security
releases on a rotation basis as outlined in the

Datadog
  bengl -
**Bryan English** <> (he/him) **Vladimir de Turckheim** <> (he/him)
NearForm
  RafaelGSS -
**Rafael Gonzaga** <> (he/him)
NodeSource
  juanarbol -
**Juan José Arboleda** <> (he/him)
Platformatic
  mcollina -
**Matteo Collina** <> (he/him)
Red Hat and IBM
  joesepi -
**Joe Sepi** <> (he/him)
  mhdawson -
**Michael Dawson** <> (he/him)

License


Node.js is available under the
MIT license. Node.js also includes
external libraries that are available under a variety of licenses.  See
LICENSE for the full
license text.

[Code of Conduct]: https://github.com/nodejs/admin/blob/HEAD/CODE_OF_CONDUCT.md
[Contributing to the project]: CONTRIBUTING.md
[Node.js website]: https://nodejs.org/
[OpenJS Foundation]: https://openjsf.org/
[Strategic initiatives]: doc/contributing/strategic-initiatives.md
[Technical values and prioritization]: doc/contributing/technical-values.md
[Working Groups]: https://github.com/nodejs/TSC/blob/HEAD/WORKING_GROUPS.md