Unable to install forge@cli

AnilMishra · April 23, 2025, 1:49pm

I’m running forge on my Windows OS
npm --version
10.5.2
node --version
v20.13.1

When i run npm install - g @forge/cli , I am getting below error.
Can you please advice what went wrong ?

C:\Users\am23925> npm install - g @forge/cli
npm ERR! code 1
npm ERR! path C:\Users\am23925\node_modules\keytar
npm ERR! command failed
npm ERR! command C:\WINDOWS\system32\cmd.exe /d /s /c prebuild-install || npm run build
npm ERR! > keytar@7.9.0 build
npm ERR! > node-gyp rebuild
npm ERR! prebuild-install warn install tunneling socket could not be established, cause=write EPROTO D06C0000:error:0A00010B:SSL routines:ssl3_get_record:wrong version number:c:\ws\deps\openssl\openssl\ssl\record\ssl3_record.c:355:
npm ERR!
npm ERR! gyp info it worked if it ends with ok
npm ERR! gyp info using node-gyp@8.2.0
npm ERR! gyp info using node@20.13.1 | win32 | x64
npm ERR! gyp info find Python using Python version 3.8.1 found at “C:\Users\am23925\AppData\Local\Programs\Python\Python38-32\python.exe”
npm ERR! gyp ERR! find VS
npm ERR! gyp ERR! find VS msvs_version not set from command line or npm config
npm ERR! gyp ERR! find VS VCINSTALLDIR not set, not running in VS Command Prompt
npm ERR! gyp ERR! find VS could not use PowerShell to find Visual Studio 2017 or newer, try re-running with ‘–loglevel silly’ for more details
npm ERR! gyp ERR! find VS looking for Visual Studio 2015
npm ERR! gyp ERR! find VS - not found
npm ERR! gyp ERR! find VS not looking for VS2013 as it is only supported up to Node.js 8
npm ERR! gyp ERR! find VS
npm ERR! gyp ERR! find VS **************************************************************
npm ERR! gyp ERR! find VS You need to install the latest version of Visual Studio
npm ERR! gyp ERR! find VS including the “Desktop development with C++” workload.
npm ERR! gyp ERR! find VS For more information consult the documentation at:
npm ERR! gyp ERR! find VS GitHub - nodejs/node-gyp: Node.js native addon build tool
npm ERR! gyp ERR! find VS **************************************************************
npm ERR! gyp ERR! find VS
npm ERR! gyp ERR! configure error
npm ERR! gyp ERR! stack Error: Could not find any Visual Studio installation to use
npm ERR! gyp ERR! stack at VisualStudioFinder.fail (C:\Users\am23925\node_modules\node-gyp\lib\find-visualstudio.js:121:47)
npm ERR! gyp ERR! stack at C:\Users\am23925\node_modules\node-gyp\lib\find-visualstudio.js:74:16
npm ERR! gyp ERR! stack at VisualStudioFinder.findVisualStudio2013 (C:\Users\am23925\node_modules\node-gyp\lib\find-visualstudio.js:351:14)
npm ERR! gyp ERR! stack at C:\Users\am23925\node_modules\node-gyp\lib\find-visualstudio.js:70:14
npm ERR! gyp ERR! stack at C:\Users\am23925\node_modules\node-gyp\lib\find-visualstudio.js:372:16
npm ERR! gyp ERR! stack at C:\Users\am23925\node_modules\node-gyp\lib\util.js:54:7
npm ERR! gyp ERR! stack at C:\Users\am23925\node_modules\node-gyp\lib\util.js:33:16
npm ERR! gyp ERR! stack at ChildProcess.exithandler (node:child_process:430:5)
npm ERR! gyp ERR! stack at ChildProcess.emit (node:events:519:28)
npm ERR! gyp ERR! stack at maybeClose (node:internal/child_process:1105:16)
npm ERR! gyp ERR! System Windows_NT 10.0.22631
npm ERR! gyp ERR! command “C:\Program Files\nodejs\node.exe” “C:\Users\am23925\node_modules\node-gyp\bin\node-gyp.js” “rebuild”
npm ERR! gyp ERR! cwd C:\Users\am23925\node_modules\keytar
npm ERR! gyp ERR! node -v v20.13.1
npm ERR! gyp ERR! node-gyp -v v8.2.0
npm ERR! gyp ERR! not ok

npm ERR! A complete log of this run can be found in: C:\Users\am23925\AppData\Local\npm-cache_logs\2025-04-23T13_24_45_253Z-debug-0.log

pedram · April 23, 2025, 6:44pm

Based on the error message, there are two main issues preventing the installation of @forge/cli:

Visual Studio Build Tools are missing: The error indicates you need to install Visual Studio with “Desktop development with C++” workload. To fix this:

a) Install Visual Studio Build Tools:

Download the Visual Studio Build Tools installer from: Microsoft C++ Build Tools - Visual Studio
During installation, make sure to select “Desktop development with C++”
Alternatively, you can install the full Visual Studio Community Edition with the C++ workload

There might be a proxy/SSL issue: The error message shows an SSL-related warning: “write EPROTO […] SSL routines:ssl3_get_record:wrong version number”

To resolve these issues, try the following steps:

First, install the required build tools:

npm install --global --production windows-build-tools

Then try installing @forge/cli again:

npm install -g @forge/cli

If you’re behind a corporate proxy, you might need to configure npm’s proxy settings:

npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080

Alternative Installation Method: If you continue to have issues, you can try:

Clear npm cache:

npm cache clean --force

Try installing with the --force flag:

npm install -g @forge/cli --force

If the problems persist after trying these solutions, you might want to:

Check if your network/proxy settings are correct
Ensure you have administrative privileges
Try running the command prompt as administrator

HeyJoe · April 24, 2025, 1:44am

We have some instructions on dealing with node-gyp installation failures here: https://developer.atlassian.com/platform/forge/enterprise/use-forge-cli-on-corporate-network/#installing-node-gyp

Essentially, the Forge CLI requires some operating system-specific dependencies to be installed, and NPM is unable to install these automatically.

You should follow the instructions in node-gyp’s readme to install those dependencies manually first.

AnilMishra · April 25, 2025, 12:59pm

Thanks for your response.
I was reading through GitHub - nodejs/node-gyp: Node.js native addon build tool
Just to confirm for MacOs it does nee just python or any additional library needed?

HeyJoe · April 28, 2025, 3:59am

says you need Python and XCode command line tools for MacOS