Installing forgeCLI on corporate network

I’m new to forge development and trying to do forge cli setup and referring this doc - https://developer.atlassian.com/platform/forge/cli-reference/

I was able to download forgecli and create sample plugin on my personal laptop however having issue with installing forgeCli on corporate network.

Could you please suggest step wise instruction for this.

I’m trying to do this on MacOS and Windows, I understand this set up requires some OS runtime dependencies like Xcode for MacOs and VIsualStudio for Windows

I installed Xcode and Python on Mac, but when I ran command - npm install -g @forge/cli --python=/usr/bin/python3, it throwing below error.
Could you please suggest what is the missing piece.

If someone can list the instruction step vise, it would be great

bash-3.2$ npm install -g @forge/cli --python=/usr/bin/python3

npm error code 1

npm error path /usr/local/lib/node_modules/@forge/cli/node_modules/keytar

npm error command failed

npm error command sh -c prebuild-install || npm run build

npm error > keytar@7.9.0 build

npm error > node-gyp rebuild

npm error prebuild-install warn install tunneling socket could not be established, statusCode=407

npm error gyp info it worked if it ends with ok

npm error gyp info using node-gyp@10.1.0

npm error gyp info using node@20.18.3 | darwin | arm64

npm error gyp info find Python using Python version 3.9.6 found at “/Applications/Xcode.app/Contents/Developer/usr/bin/python3”

npm error gyp WARN read config.gypi ENOENT: no such file or directory, open ‘/Users/am23925/node_repo/include/node/config.gypi’

npm error gyp info spawn /Applications/Xcode.app/Contents/Developer/usr/bin/python3

npm error gyp info spawn args [

npm error gyp info spawn args ‘/usr/local/lib/node_modules/npm/node_modules/node-gyp/gyp/gyp_main.py’,

npm error gyp info spawn args ‘binding.gyp’,

npm error gyp info spawn args ‘-f’,

npm error gyp info spawn args ‘make’,

npm error gyp info spawn args ‘-I’,

npm error gyp info spawn args ‘/usr/local/lib/node_modules/@forge/cli/node_modules/keytar/build/config.gypi’,

npm error gyp info spawn args ‘-I’,

npm error gyp info spawn args ‘/usr/local/lib/node_modules/npm/node_modules/node-gyp/addon.gypi’,

npm error gyp info spawn args ‘-I’,

npm error gyp info spawn args ‘/Users/am23925/node_repo/common.gypi’,

npm error gyp info spawn args ‘-Dlibrary=shared_library’,

npm error gyp info spawn args ‘-Dvisibility=default’,

npm error gyp info spawn args ‘-Dnode_root_dir=/Users/am23925/node_repo’,

npm error gyp info spawn args ‘-Dnode_gyp_dir=/usr/local/lib/node_modules/npm/node_modules/node-gyp’,

npm error gyp info spawn args ‘-Dnode_lib_file=/Users/am23925/node_repo/$(Configuration)/node.lib’,

npm error gyp info spawn args ‘-Dmodule_root_dir=/usr/local/lib/node_modules/@forge/cli/node_modules/keytar’,

npm error gyp info spawn args ‘-Dnode_engine=v8’,

npm error gyp info spawn args ‘–depth=.’,

npm error gyp info spawn args ‘–no-parallel’,

npm error gyp info spawn args ‘–generator-output’,

npm error gyp info spawn args ‘build’,

npm error gyp info spawn args ‘-Goutput_dir=.’

npm error gyp info spawn args ]

npm error gyp: /Users/anil/node_repo/common.gypi not found (cwd: /usr/local/lib/node_modules/@forge/cli/node_modules/keytar) while reading includes of binding.gyp while trying to load binding.gyp

npm error gyp ERR! configure error

npm error gyp ERR! stack Error: gyp failed with exit code: 1

npm error gyp ERR! stack at ChildProcess. (/usr/local/lib/node_modules/npm/node_modules/node-gyp/lib/configure.js:297:18)

npm error gyp ERR! stack at ChildProcess.emit (node:events:518:28)

npm error gyp ERR! stack at ChildProcess._handle.onexit (node:internal/child_process:293:12)

npm error gyp ERR! System Darwin 24.5.0

npm error gyp ERR! command “/usr/local/bin/node” “/usr/local/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js” “rebuild”

npm error gyp ERR! cwd /usr/local/lib/node_modules/@forge/cli/node_modules/keytar

npm error gyp ERR! node -v v20.18.3

npm error gyp ERR! node-gyp -v v10.1.0

npm error gyp ERR! not ok

This guide is specifically for corporate networks: https://developer.atlassian.com/platform/forge/enterprise/use-forge-cli-on-corporate-network/

Hi Aaron,
Thanks for your reply.
I have taken the look on this guide already and tried to followed the same , may be i have missed something but sharing the step I have performed.

  1. Installed XCoded - (xcode-select --install
    xcode-select: note: Command line tools are already installed.)

  2. Installed python (python3 --version - Python 3.9.6)

  3. Ran npm install -g @forge/cli - Got error for node-gyp

  4. Ran - npm install -g node-gyp
    changed 100 packages in 15s, 17 packages are looking for funding

  5. Ran - npm install -g global-agent
    Output: added 21 packages in 9s, 8 packages are looking for funding

  6. npm list -g --depth=0
    /usr/local/lib
    ├── build@
    ├── corepack@0.30.0
    ├── global-agent@3.0.0
    ├── node-gyp@11.2.0
    └── npm@10.8.2

  7. npm install -g @forge/cli

npm error code 1

npm error path /usr/local/lib/node_modules/@forge/cli/node_modules/keytar

npm error command failed

npm error command sh -c prebuild-install || npm run build

npm error > keytar@7.9.0 build

npm error > node-gyp rebuild

npm error prebuild-install warn install tunneling socket could not be established, statusCode=407

npm error gyp info it worked if it ends with ok

npm error gyp info using node-gyp@10.1.0

npm error gyp info using node@20.18.3 | darwin | arm64

npm error gyp info find Python using Python version 3.9.6 found at “/Applications/Xcode.app/Contents/Developer/usr/bin/python3”

npm error gyp WARN read config.gypi ENOENT: no such file or directory, open ‘/Users/anil/node_repo/include/node/config.gypi’

npm error gyp info spawn /Applications/Xcode.app/Contents/Developer/usr/bin/python3

npm error gyp info spawn args [

npm error gyp info spawn args ‘/usr/local/lib/node_modules/npm/node_modules/node-gyp/gyp/gyp_main.py’,

npm error gyp info spawn args ‘binding.gyp’,

npm error gyp info spawn args ‘-f’,

npm error gyp info spawn args ‘make’,

npm error gyp info spawn args ‘-I’,

npm error gyp info spawn args ‘/usr/local/lib/node_modules/@forge/cli/node_modules/keytar/build/config.gypi’,

npm error gyp info spawn args ‘-I’,

npm error gyp info spawn args ‘/usr/local/lib/node_modules/npm/node_modules/node-gyp/addon.gypi’,

npm error gyp info spawn args ‘-I’,

npm error gyp info spawn args ‘/Users/anil/node_repo/common.gypi’,

npm error gyp info spawn args ‘-Dlibrary=shared_library’,

npm error gyp info spawn args ‘-Dvisibility=default’,

npm error gyp info spawn args ‘-Dnode_root_dir=/Users/anil/node_repo’,

npm error gyp info spawn args ‘-Dnode_gyp_dir=/usr/local/lib/node_modules/npm/node_modules/node-gyp’,

npm error gyp info spawn args ‘-Dnode_lib_file=/Users/anil/node_repo/$(Configuration)/node.lib’,

npm error gyp info spawn args ‘-Dmodule_root_dir=/usr/local/lib/node_modules/@forge/cli/node_modules/keytar’,

npm error gyp info spawn args ‘-Dnode_engine=v8’,

npm error gyp info spawn args ‘–depth=.’,

npm error gyp info spawn args ‘–no-parallel’,

npm error gyp info spawn args ‘–generator-output’,

npm error gyp info spawn args ‘build’,

npm error gyp info spawn args ‘-Goutput_dir=.’

npm error gyp info spawn args ]

npm error gyp: /Users/anil/node_repo/common.gypi not found (cwd: /usr/local/lib/node_modules/@forge/cli/node_modules/keytar) while reading includes of binding.gyp while trying to load binding.gyp

npm error gyp ERR! configure error

npm error gyp ERR! stack Error: gyp failed with exit code: 1

npm error gyp ERR! stack at ChildProcess. (/usr/local/lib/node_modules/npm/node_modules/node-gyp/lib/configure.js:297:18)

npm error gyp ERR! stack at ChildProcess.emit (node:events:518:28)

npm error gyp ERR! stack at ChildProcess._handle.onexit (node:internal/child_process:293:12)

npm error gyp ERR! System Darwin 24.5.0

npm error gyp ERR! command “/usr/local/bin/node” “/usr/local/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js” “rebuild”

npm error gyp ERR! cwd /usr/local/lib/node_modules/@forge/cli/node_modules/keytar

npm error gyp ERR! node -v v20.18.3

npm error gyp ERR! node-gyp -v v10.1.0

npm error gyp ERR! not ok

Based on error prebuild-install warn install tunneling socket could not be established, statusCode=407, it might be an issue with the proxy: https://developer.atlassian.com/platform/forge/enterprise/use-forge-cli-on-corporate-network/#configuring-the-development-environment-to-work-with-an-http-proxy
But that’s just a guess. :person_shrugging:

I did set the proxy setup before forge install command
npm config set proxy= proxy url