Solve - gulp: command not found error

avatar

Borislav Hadzhiev

Mon Mar 14 20223 min read

Solve - gulp: command not found error #

To solve the error "gulp: command not found", install the gulp-cli package globally by running npm install -g gulp-cli and restart your terminal. If the command fails, run it with sudo and make sure the correct PATH is set in your system's environment variable.

command not found gulp

Open your terminal and install the gulp cli globally by running the following command.

shell
# 1. install gulp-cli globally npm install -g gulp-cli # 2. Create a directory and initialize your project # 3. In your project directory install gulp as dev dependency npm install --save-dev gulp # 👇️ if command outputs version, gulp is installed gulp --version

If the gulp --version command outputs a version number, then gulp is installed successfully.

If the global installation of gulp fails, you might have to run the command prefixed with sudo.
shell
# 1. If you got permissions error, run with sudo sudo npm install -g gulp-cli # 2. Create a directory and initialize your project # 3. In your project directory install gulp as dev dependency npm install --save-dev gulp # 👇️ if command outputs version, gulp is installed gulp --version
If the "gulp: command not found" error is not resolved, try restarting your terminal.

If that doesn't help, run the following command:

shell
npm config get prefix

The command will show you the path where npm puts your globally installed packages. The global packages will be in the bin directory at the specified path.

Look at the PATH environment variable on your operating system and add the path that the npm config get prefix command outputs, if it's not already there.

If you add the output from the command to your PATH environment variable, you have to restart any open command prompts before it takes effect.

If that didn't work, try to add the path to the bin folder (from npm config get prefix) to your PATH environment variable and restart your terminal.

For example, on macOS, you can update your path with the following command:

shell
# make sure path matches with npm config get prefix export PATH=/usr/local/share/npm/bin:$PATH

And on Windows, the output of the npm config get prefix command will look something like: C:\Users\Your_User_Name\AppData\Roaming\npm.

Edit the environment variable on your machine and add the specified path (replacing the placeholder with your username).

If you are on linux, you can add the output from the npm config get prefix command to your .bashrc file.

~/.bashrc
# 👇️ make sure to update the path with the output # from the command export PATH="/usr/local/share/npm/bin:$PATH"
If you add the output from the command to your PATH environment variable, you have to restart any open command prompts before it takes effect.

If that doesn't help try to reinstall Node.js on your machine and then install the gulp cli globally by running npm install -g gulp-cli.

During the installation you might get a prompt for whether you want to automatically update the PATH environment variable on your system, make sure to tick the option.
shell
# 1. install gulp-cli globally npm install -g gulp-cli # 2. Create a directory and initialize your project # 3. In your project directory install gulp as dev dependency npm install --save-dev gulp # 👇️ if command outputs version, gulp is installed gulp --version

If the gulp --version command outputs a version number, then gulp is installed successfully.

If the global installation of gulp fails, you might have to run the command prefixed with sudo.
shell
# 1. If you got permissions error, run with sudo sudo npm install -g gulp-cli # 2. Create a directory and initialize your project # 3. In your project directory install gulp as dev dependency npm install --save-dev gulp # 👇️ if command outputs version, gulp is installed gulp --version

Alternatively, you can see how you can fix the permissions error on this page in the official npm docs.

Use the search field on my Home Page to filter through my more than 1,000 articles.