semantic-release/docs/usage/installation.md
Matt Travi 66cc2b4c7f
feat(node-version): raised the minimum required version to v14.17 (#2132)
BREAKING CHANGE: the minimum required version of node is now v14.17
2021-09-17 13:05:32 -07:00

1.3 KiB

Installation

Local installation

For Node modules projects we recommend installing semantic-release locally and running the semantic-release command with npx:

$ npm install --save-dev semantic-release

Then in the CI environment:

$ npx semantic-release

Note: npx is a tool bundled with npm@>=5.2.0. It is used to conveniently find the semantic-release binary and to execute it. See What is npx for more details.

Global installation

For other type of projects we recommend installing semantic-release directly in the CI environment, also with npx:

$ npx semantic-release

Note: For a global installation, it's recommended to specify the major semantic-release version to install (for example with with npx semantic-release@18). This way your build will not automatically use the next major semantic-release release that could possibly break your build. You will have to upgrade manually when a new major version is released.

Note: npx is a tool bundled with npm@>=5.2.0. It is used to conveniently install the semantic-release binary and to execute it. See What is npx for more details.