Node.js Troubleshooting

Unable to find specific versions of node/npm/pnpm/yarn commands

If you encounter an error similar to the one below:

Warning: Specified Node.js version '22' for 'node' not found.
If this is not your intention, please delete the 'NODE_VERSION' configuration
from the '.servbay.config' file in the current directory.

This is because the specified version of Node.js is not installed in ServBay or the user intends to use the Node.js version included with nvm, but due to configuration issues, nvm or the Node.js version installed via homebrew cannot be found.

Tip

After installing ServBay, the priority order for finding the node command is: ServBay -> nvm -> homebrew

Cause: After installing ServBay, the Script Alias of ServBay automatically takes precedence to use the Node.js installed by ServBay. When a certain version of Node.js cannot be found, it will automatically fall back to the default version of Node.js installed by nvm. If the user's system does not have nvm installed, or if nvm is misconfigured, the system will continue to fall back to the Node.js version installed by homebrew. If the Node.js version installed by homebrew cannot be found either, the above error will be reported.

Solution: Some users have installed nvm and used it to install Node.js but still encounter the error above. This is because the NVM_BIN environment variable is missing from the user's environment configuration. When nvm is installed, it automatically configures this variable.

Users only need to fix this variable to correctly locate the Node.js installed by nvm.

Unsupported architecture error when using npm packages like node-sass

Users with Apple Silicon (M1/M2/M3/M4) or other Arm64 chips may encounter the Unsupported architecture (arm64) error when using some older npm packages (like node-sass). This is due to Apple's M series chips being Arm64 architecture, whereas packages like node-sass only support the x86_64 chip architecture.

ERROR: Module Error (from ./node_modules/sass-loader/dist/cjs.js): 
Node Sass does not yet support your current environment: OS X Unsupported architecture (arm64) with Node.js 14.x 
For more information on which environments are supported
please see:
https://github.com/sass/node-sass/releases/tag/v4.14.1

Solution:

1. Switch to a more modern npm package that supports Arm64 (for example, replace node-sass with sass).

npm uninstall node-sass
npm install --save-dev sass

2. ServBay offers the option to install the x86_64 version of Node.js; users can choose to install the x86_64 architecture version of Node.js in the Node.js installation interface (not recommended).