Common installation issues

List of common errors

If you get an error that is not listed below, please open a new issue with your OS, Node version, and the full console output.

Cannot find module '../../binding.node'
- Remove the node_modules directory and try npm install again.
- Check for specific build errors when running npm install.

gyp ERR! stack Error: Could not find any Python installation to use
- Your system is not configured with build tools.
- For Windows, run npm i -g windows-build-tools as admin, or reinstall Node.js with the build tools option checked.
- For other systems, install Python and gcc.

gyp: Call to 'node -p "require('node-addon-api').include_dir"' returned exit status 0 while in binding.gyp. while trying to load binding.gyp
- The node -p "require('node-addon-api').include_dir" command is returning an error (or some text in stderr).
- This could be due to having a debugger attached. Try using a different terminal/shell.
- Other dependencies might require a version of node-addon-api below 3.0.2. Try npm i node-addon-api

gyp ERR! stack Error: gyp failed with exit code: 1
- Something went wrong during build. Check if any of the output matches the above errors, otherwise open a new issue.

fatal error C1083: Cannot open include file: 'napi.h': No such file or directory
- Other dependencies might require a version of node-addon-api below 3.0.2. Try npm i node-addon-api

gyp ERR! stack SyntaxError: invalid syntax
- You're likely running Python 3, while this addon requires Python 2 to be built.
- Install Python 2 and/or set the path with env vars or npm config set python /path/to/python