diff --git a/docs/docker.md b/docs/docker.md
index 3f71152167ae..e7d0ba1fe713 100644
--- a/docs/docker.md
+++ b/docs/docker.md
@@ -11,6 +11,12 @@ The next best thing you can do is using BuildKit cache mount to share cache betw
 
 :::
 
+:::note
+
+If you are using node version newer than 25, you may replace `corepack enable` with `npm install -g pnpm@latest`.
+
+:::
+
 [podman]: ./podman.md
 
 ## Minimizing Docker image size and build time
diff --git a/docs/podman.md b/docs/podman.md
index 385b2cef791b..f9d36ff254e3 100644
--- a/docs/podman.md
+++ b/docs/podman.md
@@ -22,6 +22,7 @@ FROM node:20-slim
 
 # corepack is an experimental feature in Node.js v20 which allows
 # installing and managing versions of pnpm, npm, yarn
+# If you are using node version newer than 25, replace it with `npm install -g pnpm@latest`.
 RUN corepack enable
 
 VOLUME [ "/pnpm-store", "/app/node_modules" ]