This guide goes through the various methods used to install webpack.
Before we begin, make sure you have a fresh version of Node.js installed. The current Long Term Support (LTS) release is an ideal starting point. You may run into a variety of issues with the older versions as they may be missing functionality webpack and/or its related packages require.
The latest webpack release is:
To install the latest release or a specific version, run one of the following commands:
npm install --save-dev webpack
# or specific version
npm install --save-dev webpack@<version>
Whether to use
--save-dev
or not depends on your use cases. Say you're using webpack only for bundling, then it's suggested that you install it with--save-dev
option since you're not going to include webpack in your production build. Otherwise you can ignore--save-dev
.
If you're using webpack v4 or later, you'll also need to install the CLI.
npm install --save-dev webpack-cli
Installing locally is what we recommend for most projects. This makes it easier to upgrade projects individually when breaking changes are introduced. Typically webpack is run via one or more npm scripts which will look for a webpack installation in your local node_modules
directory:
"scripts": {
"build": "webpack --config webpack.config.js"
}
To run the local installation of webpack you can access its binary version as
node_modules/.bin/webpack
. Alternatively, if you are using npm v5.2.0 or greater, you can run 'npx webpack' to do it.
The following NPM installation will make webpack
available globally:
npm install --global webpack
Note that this is not a recommended practice. Installing globally locks you down to a specific version of webpack and could fail in projects that use a different version.
If you are enthusiastic about using the latest that webpack has to offer, you can install beta versions or even directly from the webpack repository using the following commands:
npm install --save-dev webpack@next
# or a specific tag/branch
npm install --save-dev webpack/webpack#<tagname/branchname>
Take caution when installing these bleeding edge releases! They may still contain bugs and therefore should not be used in production.