404

I removed the old version of grunt first, then I installed the new grunt version, and then I got this error:

D:\www\grunt-test\grunt grunt-cli: The grunt command line interface. (v0.1.4)

Fatal error: Unable to find local grunt.

If you're seeing this message, either a Gruntfile wasn't found or grunt hasn't been installed locally to your project. For more information about installing and configuring grunt, please see the Getting Started guide: http://gruntjs.com/getting-started

Is this because there is not a reference to grunt in my system path? Or something else? I tried to re-install it a few times already.

14
  • 6
    Did you install globally? npm install grunt -g
    – elclanrs
    Dec 18, 2012 at 3:43
  • 1
    do you have a Gruntfile.js at the root of your project? Dec 18, 2012 at 3:44
  • 6
    @Garreh It's been a while, but try npm install grunt --save-dev from the terminal. This should add the latest version to your package.json.
    – Romain
    Sep 20, 2013 at 13:10
  • 248
    Oops - had this with a newly checked out project. Just needed to do npm install! Oct 11, 2013 at 14:14
  • 6
    nmp install - Installs the dependencies in the local node_modules folder.
    – poorva
    Dec 27, 2013 at 11:27

13 Answers 13

306

I think you don't have a grunt.js file in your project directory. Use grunt:init, which gives you options such as jQuery, node,commonjs. Select what you want, then proceed. This really works. For more information you can visit this.

Do this:

 1. npm install -g grunt
 2. grunt:init  ( you will get following options ):
      jquery: A jQuery plugin
      node: A Node module
      commonjs: A CommonJS module
      gruntplugin: A Grunt plugin
      gruntfile: A Gruntfile (grunt.js)
 3 .grunt init:jquery (if you want to create a jQuery related project.).

It should work.

Solution for v1.4:

1. npm install -g grunt-cli
2. npm init
   fill all details and it will create a package.json file.
3. npm install grunt (for grunt dependencies.)

Edit : Updated solution for new versions:

 npm install grunt --save-dev
8
  • 2
    This version must be the old one(v0.3).today I'm unintsalled it,and install the new grunt(v0.4) called Grunt-CLI.something has changed..
    – Ryan Yiada
    Dec 18, 2012 at 7:09
  • 29
    Currently, npm install grunt installs grunt 0.3.x. You'll need to do `npm install [email protected]' go locally install the version of grunt needed for grunt-cli
    – Jack
    Jan 16, 2013 at 1:46
  • 6
    I wish the Grunt install steps would address the @0.4. Was really wringing my hands trying to figure this out until I found your comment.
    – cnp
    Feb 7, 2013 at 21:03
  • 2
    npm install grunt --save-dev did it for me Aug 6, 2014 at 21:00
  • 6
    grunt-cli should be installed globally, but it expects you to have a local install of grunt.js in your project. This allows each project to use a different version of grunt. I typically use npm with a package.json file to install grunt.js all any other grunt conribs etc.
    – Henry
    Oct 29, 2014 at 23:54
193

Install Grunt in node_modules rather than globally

Unable to find local Grunt likely means that you have installed Grunt globally.

The Grunt CLI insists that you install grunt in your local node_modules directory, so Grunt is local to your project.

This will fail:

npm install -g grunt

Do this instead:

npm install grunt --save-dev
1
  • 1
    This solved my issue. Not sure how it isn't accepted. Good stuff.
    – Andy
    Apr 11, 2021 at 12:27
86

Do

npm install

to install Grunt locally in ./node_modules (and everything else specified in the package.json file)

4
  • 4
    I did that cause like a fool I forgot running this command after pulling the new fresh project's repo to mac..... :/
    – neoswf
    Jun 5, 2015 at 16:07
  • 2
    How come grunt needs to be installed locally since the command line tool can always be located globally?
    – Mike M
    Aug 18, 2015 at 14:22
  • 1
    @MikeM sometimes you have node_modules/.bin in your PATH. Also, local and global can be different versions. Aug 19, 2015 at 10:59
  • In my case it was NetBeans' fault. Sometimes it crashes my projects when I do git stash in external tool, here it removed some modules from node_modules and everything stopped working (and was working fine before). After npm install it works well again.
    – Wirone
    Oct 7, 2015 at 9:05
27

If you already have a file package.json in the project and it contains grunt in dependency,

  "devDependencies": {
    "grunt": "~0.4.0",

Then you can run npm install to resolve the issue

0
7

I made the mistake to install some packages using sudo and other without privileges , this fixed my problem.

sudo chown -R $(whoami) $HOME/.npm

hope it helps someone.

5

It says you don't have a local grunt so try:

npm install grunt

(without the -g it's a local grunt)

Though not directly related, make sure you have Gruntfile.js in your current folder.

4

Could be a few problems here depending on what version of grunt is being used. Newer versions of grunt actually specify that you have a file named Gruntfile.js (instead of the old grunt.js).

You should have the grunt-cli tool be installed globally (this is done via npm install -g grunt-cli). This allows you to actually run grunt commands from the command line.

Secondly make sure you've installed grunt locally for your project. If you see your package.json doesn't have something like "grunt": "0.4.5" in it then you should do npm install grunt --save in your project directory.

3

I had to execute the following commands on ubuntu to solve this problem (I know grunt for 1 hour) :

sudo npm install -g grunt
sudo npm install -g grunt-cli

cd /usr/local/bin
# current symlink points to ../lib/node_modules/grunt/bin/grunt*
sudo rm /usr/local/bin/grunt
sudo ln -s ../lib/node_modules/grunt-cli/bin/grunt* grunt

It is dirty but it is the only one solution I found... :(

0
2

None of the above worked for me because i had grunt installed globally (recommended in several of these answers, oddly) and that was messing everything up. Here's what did work:

npm uninstall -g grunt
npm install

Only now was a local grunt installed, and useable, for me.

0
2

You can simply run this command:

npm install grunt --save-dev
0
1

Just npm install to install node_modules

0
0

Being new to grunt and setting it up, I am running (perhaps foolishly) my grunt project/folder from a Google Drive so I can access the same code/builds from either my laptop or workstation.

There is a fair bit of synchronisation of the nodes_modules folders back to Google Drive and there seemed to be a conflict at some point, and the /nodes_modules/grunt folder was renamed to /nodes_modules/grunt (1)

Renaming it back by removing the (1) seemed to fix it for me.

2
  • Why don't you use GIT?
    – hmrc87
    Jun 15, 2016 at 6:13
  • I wasnt wanting to track/versions changes and was trying not to maintain two separate grunt installs, but the above scenario was fairly problematic so I have moved around to github anyway.
    – LJT
    Jun 15, 2016 at 11:18
0

I had the same issue in Vagrant.

I have used sudo to run the command to install.

sudo npm install -g grunt-cli

It worked for me.

Not the answer you're looking for? Browse other questions tagged or ask your own question.