docs: clarify Node.js v22.13.0 minimum and note Alpine Docker gotcha#262
docs: clarify Node.js v22.13.0 minimum and note Alpine Docker gotcha#262Alike001 wants to merge 1 commit into
Conversation
|
@Alike001 is attempting to deploy a commit to the Nomic Foundation Team on Vercel. A member of the Team first needs to authorize it. |
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
Hey, I'll review this properly tomorrow, but out of curiosity, why do you use node 22 if you are using it with docker? |
|
Hey @alcuadrado The reason was just that the Hardhat 3 docs say "Node.js v22 or later", so when I dockerized my hardhat-greeter project I picked |
|
Thanks for sharing, @Alike001! I just wanted to know if there was some limitation that prevent you from upgrading. I'll get back to this PR today |
Summary
Updates the Hardhat 3 Getting Started page to match the Node.js version that the CLI actually enforces, and adds a short note for Docker users.
Why
The current docs say:
But the Hardhat 3 CLI enforces a stricter minimum in source:
A user following the docs literally — for example by pulling
node:22-alpineor installing Node 22.10.x — falls inside the documented range but hits a runtime error from the version check. The Alpine case is especially common because the plainnode:22-alpinetag is not guaranteed to ship the latest patch version.Issue: NomicFoundation/hardhat#8293
Change
src/content/docs/docs/getting-started.mdx:v22 or latertov22.13.0 or later.node:22.13-alpine).Notes
Trivial markdown change — no local build run. Indentation matches the existing nested-bullet style elsewhere in the docs. Happy to amend the wording or move the Docker note into a
:::tipcallout if maintainers prefer.