Environment requirements
The Node.js, npm, and Git versions MDK's tooling expects, and why npm stays below 12
Overview
Every guide and tutorial in this repo assumes the same baseline; this page explains the npm ceiling.
Requirements
- Node.js >=24 (LTS)
- npm 11 (< 12)
- Git (latest stable version)
Check the installed npm version with npm --version.
Why npm stays below 12
npm 12 disables fetching git-based dependencies by default and fails with EALLOWGIT:
npm error code EALLOWGIT
npm error Fetching packages of type "git" have been disabledexamples/full-site and examples/mvp-site depend on the Whatsminer Worker directly from its
git repository, so npm install on npm 12 fails on that dependency before it reaches anything else.
If npm --version already reports 12 or higher, repin with:
npm install -g npm@11