Install

Cypress is installed as a dev dependency into an existing Node.js project. Choose your package manager:

npm

npm install cypress --save-dev

pnpm

pnpm add --save-dev cypress

yarn

yarn add cypress --dev

bun

bun add --dev cypress

System Requirements

Requirement	Minimum
Node.js	20.x, 22.x, or >= 24.x
npm	>= 10.1.0
pnpm	>= 8.x
Bun	>= 1.2.22
macOS	13.5+
Windows	10 / 11 / Server 2019+
Linux	Supported (headless mode works well in CI)

Verify the Install

After installation, verify the CLI is available:

npx cypress --version

Expected output (version numbers will vary):

Cypress package version: 15.18.0
Cypress binary version: 15.18.0
Electron version: 36.3.1
Bundled Node version: 22.15.1

Notes

• Cypress ships with a full Electron-based browser and also supports Chrome, Firefox, and Edge.
• The first run downloads the Cypress binary (several hundred MB). Subsequent runs use the cached binary.
• No global install is needed. npx cypress works from any project that has it as a dev dependency.