DC-6378 Docker version warning added by aidankmcalister · Pull Request #7335 · prisma/docs

aidankmcalister · 2025-11-26T20:07:14Z

Added the following warning to various places relating to Docker

:::warning

Prisma 7.0.0 has updated minimum Node.js requirements:
- Node.js 20: >= 20.19.0
- Node.js 22: >= 22.12.0  
- Node.js 24: >= 24.0.0+

If you're using Prisma 7.0.0 or higher with Docker, ensure your application's Docker base image uses Node.js 22 or 24. Update your Dockerfile to use `node:22-alpine` or `node:24-alpine` instead of older Node.js 20 images.

:::

Summary by CodeRabbit

Documentation
- Updated minimum Node.js version requirements for Prisma 7.0.0+
- Added Docker base image recommendations for Node.js 22 or 24
- Enhanced guidance across Docker, integration testing, and database configuration documentation

_{✏️ Tip: You can customize this high-level summary in your review settings.}

coderabbitai · 2025-11-26T20:07:28Z

Walkthrough

This PR adds warning blocks across three documentation files specifying that Prisma 7.0.0+ requires Node.js 20, 22, or 24, and recommends Docker base images (node:22-alpine or node:24-alpine). No functional logic or code changes are present—purely informational content insertions.

Changes

Cohort / File(s)	Summary
Documentation Updates - Prisma 7.0.0 Node.js Warnings `content/200-orm/050-overview/500-databases/800-sql-server/030-sql-server-docker.mdx`, `content/200-orm/200-prisma-client/450-testing/150-integration-testing.mdx`, `content/800-guides/130-docker.mdx`	Added warning blocks specifying Prisma 7.0.0 minimum Node.js requirements (versions 20, 22, 24) and recommending Docker base images (node:22-alpine or node:24-alpine).

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

All changes are purely informational documentation updates with consistent, repetitive patterns
No code logic, control flow, or structural changes to review
Straightforward prerequisite/warning blocks across clearly separated documentation sections

Possibly related PRs

DC-5039 Update Node and TS Versions #7234: Updates system-requirements table to reflect new Node.js minimum versions for Prisma 7.0.0, complementing this PR's warning-based approach to the same versioning guidance.
DC-5237 NestJS Guide #7327: Modifies prerequisites across multiple guides to raise Node.js minimums, overlapping with this PR's focus on communicating version requirements across documentation.
docs(): add v7 migration guide #7249: Introduces v7 migration guide that covers the same Node.js version requirements for Prisma 7.0.0 that this PR warns about in Docker and testing contexts.

Pre-merge checks

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately reflects the main change: adding Docker version warnings about Node.js requirements for Prisma 7.0.0 across multiple documentation files.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

📜 Recent review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 7a86cf0 and ac46076.

📒 Files selected for processing (3)

content/200-orm/050-overview/500-databases/800-sql-server/030-sql-server-docker.mdx (1 hunks)
content/200-orm/200-prisma-client/450-testing/150-integration-testing.mdx (1 hunks)
content/800-guides/130-docker.mdx (1 hunks)

🧰 Additional context used

🧠 Learnings (7)

📓 Common learnings

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7157
File: content/800-guides/400-deno-integration.mdx:188-190
Timestamp: 2025-10-03T19:30:57.554Z
Learning: For the prisma/docs repository, do not suggest changes to code blocks when reviewing documentation pull requests.

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7301
File: content/800-guides/410-cloudflare-workers.mdx:87-107
Timestamp: 2025-11-20T21:00:02.587Z
Learning: Do not suggest changes to `prisma.config.ts` files in the prisma/docs repository, as the code examples are intentional for documentation purposes.

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: Only flag code snippets for (1) exposed secrets with real-looking values that should be placeholders (e.g., API keys, database passwords, AWS credentials), or (2) blatant syntax errors like missing parentheses, brackets, braces, or mismatched delimiters. Do not flag code quality issues, anti-patterns, security vulnerabilities, missing error handling, unused variables, or any other bad practices, as documentation intentionally shows problematic code.

📚 Learning: 2025-11-20T21:00:02.587Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7301
File: content/800-guides/410-cloudflare-workers.mdx:87-107
Timestamp: 2025-11-20T21:00:02.587Z
Learning: Do not suggest changes to `prisma.config.ts` files in the prisma/docs repository, as the code examples are intentional for documentation purposes.

Applied to files:

content/800-guides/130-docker.mdx
content/200-orm/050-overview/500-databases/800-sql-server/030-sql-server-docker.mdx
content/200-orm/200-prisma-client/450-testing/150-integration-testing.mdx

📚 Learning: 2025-10-09T21:32:50.340Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7167
File: content/900-ai/prompts/astro.mdx:84-84
Timestamp: 2025-10-09T21:32:50.340Z
Learning: The `npx prisma init` command supports the following flags: `--db` (shorthand for `--datasource-provider prisma+postgres`), `--output` (specifies output location for generated client), `--generator-provider` (defines the generator provider), `--datasource-provider`, `--url`, `--preview-feature`, and `--with-model`. These are documented valid CLI options for Prisma init command.

Applied to files:

content/800-guides/130-docker.mdx

📚 Learning: 2025-10-08T16:23:00.388Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: Only flag code snippets for (1) exposed secrets with real-looking values that should be placeholders (e.g., API keys, database passwords, AWS credentials), or (2) blatant syntax errors like missing parentheses, brackets, braces, or mismatched delimiters. Do not flag code quality issues, anti-patterns, security vulnerabilities, missing error handling, unused variables, or any other bad practices, as documentation intentionally shows problematic code.

Applied to files:

content/200-orm/050-overview/500-databases/800-sql-server/030-sql-server-docker.mdx
content/200-orm/200-prisma-client/450-testing/150-integration-testing.mdx

📚 Learning: 2025-10-03T19:30:57.554Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7157
File: content/800-guides/400-deno-integration.mdx:188-190
Timestamp: 2025-10-03T19:30:57.554Z
Learning: For the prisma/docs repository, do not suggest changes to code blocks when reviewing documentation pull requests.

Applied to files:

content/200-orm/050-overview/500-databases/800-sql-server/030-sql-server-docker.mdx

📚 Learning: 2025-10-08T16:22:57.129Z

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:50-66
Timestamp: 2025-10-08T16:22:57.129Z
Learning: In `.mdx` files, do NOT flag or suggest changes for the following code quality issues even if they represent poor practices: React anti-patterns (using var instead of useState, direct DOM manipulation), missing keys in .map() iterations, non-serializable props in getServerSideProps, unused variables, missing error handling, SQL injection vulnerabilities (unless actively showing how to fix them), insecure cookie settings, missing TypeScript types, PrismaClient instantiation patterns, or any other code quality, security, or performance issues. Documentation code snippets are copied from source code and often intentionally show "before" examples or common mistakes.

Applied to files:

content/200-orm/050-overview/500-databases/800-sql-server/030-sql-server-docker.mdx
content/200-orm/200-prisma-client/450-testing/150-integration-testing.mdx

📚 Learning: 2025-08-11T09:40:55.237Z

Learnt from: ankur-arch
Repo: prisma/docs PR: 7066
File: content/200-orm/200-prisma-client/700-debugging-and-troubleshooting/245-troubleshooting-binary-size-issues.mdx:8-22
Timestamp: 2025-08-11T09:40:55.237Z
Learning: When the queryCompiler preview feature is enabled in Prisma ORM (v6.7.0+), it does not require Rust engines for CLI tools like `prisma migrate` or `prisma db pull`. The previous understanding that CLI tools would still need Rust binaries even with queryCompiler enabled is incorrect.

Applied to files:

content/200-orm/200-prisma-client/450-testing/150-integration-testing.mdx

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)

GitHub Check: Check internal links
GitHub Check: Cloudflare Pages

🔇 Additional comments (4)

content/200-orm/050-overview/500-databases/800-sql-server/030-sql-server-docker.mdx (2)

11-20: Consistent and well-placed prerequisite warning across all documentation sections.

The warning messaging, Docker image recommendations (node:22-alpine and node:24-alpine), and placement in the prerequisites sections are clear, actionable, and appropriately warn users about the breaking changes in Prisma 7.0.0. The consistency of this warning across all three files is excellent for ensuring comprehensive coverage.

11-20: Minor formatting inconsistency in version specification (third instance).

Line 16 repeats the same trailing + issue: Node.js 24: >= 24.0.0+ should be Node.js 24: >= 24.0.0 to match lines 14-15 and the other two documentation files.

⛔ Skipped due to learnings

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: Only flag code snippets for (1) exposed secrets with real-looking values that should be placeholders (e.g., API keys, database passwords, AWS credentials), or (2) blatant syntax errors like missing parentheses, brackets, braces, or mismatched delimiters. Do not flag code quality issues, anti-patterns, security vulnerabilities, missing error handling, unused variables, or any other bad practices, as documentation intentionally shows problematic code.

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:50-66
Timestamp: 2025-10-08T16:22:57.129Z
Learning: In `.mdx` files, do NOT flag or suggest changes for the following code quality issues even if they represent poor practices: React anti-patterns (using var instead of useState, direct DOM manipulation), missing keys in .map() iterations, non-serializable props in getServerSideProps, unused variables, missing error handling, SQL injection vulnerabilities (unless actively showing how to fix them), insecure cookie settings, missing TypeScript types, PrismaClient instantiation patterns, or any other code quality, security, or performance issues. Documentation code snippets are copied from source code and often intentionally show "before" examples or common mistakes.

Learnt from: ankur-arch
Repo: prisma/docs PR: 7066
File: content/200-orm/200-prisma-client/700-debugging-and-troubleshooting/245-troubleshooting-binary-size-issues.mdx:8-22
Timestamp: 2025-08-11T09:40:55.237Z
Learning: When the queryCompiler preview feature is enabled in Prisma ORM (v6.7.0+), it does not require Rust engines for CLI tools like `prisma migrate` or `prisma db pull`. The previous understanding that CLI tools would still need Rust binaries even with queryCompiler enabled is incorrect.

content/200-orm/200-prisma-client/450-testing/150-integration-testing.mdx (1)

22-31: Minor formatting inconsistency in version specification (duplicate issue).

Line 27 has the same trailing + issue as the other files: Node.js 24: >= 24.0.0+ should be Node.js 24: >= 24.0.0 for consistency with lines 25-26 and alignment with standard version notation.

⛔ Skipped due to learnings

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:50-66
Timestamp: 2025-10-08T16:22:57.129Z
Learning: In `.mdx` files, do NOT flag or suggest changes for the following code quality issues even if they represent poor practices: React anti-patterns (using var instead of useState, direct DOM manipulation), missing keys in .map() iterations, non-serializable props in getServerSideProps, unused variables, missing error handling, SQL injection vulnerabilities (unless actively showing how to fix them), insecure cookie settings, missing TypeScript types, PrismaClient instantiation patterns, or any other code quality, security, or performance issues. Documentation code snippets are copied from source code and often intentionally show "before" examples or common mistakes.

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: Only flag code snippets for (1) exposed secrets with real-looking values that should be placeholders (e.g., API keys, database passwords, AWS credentials), or (2) blatant syntax errors like missing parentheses, brackets, braces, or mismatched delimiters. Do not flag code quality issues, anti-patterns, security vulnerabilities, missing error handling, unused variables, or any other bad practices, as documentation intentionally shows problematic code.

Learnt from: ankur-arch
Repo: prisma/docs PR: 7066
File: content/200-orm/200-prisma-client/700-debugging-and-troubleshooting/245-troubleshooting-binary-size-issues.mdx:8-22
Timestamp: 2025-08-11T09:40:55.237Z
Learning: When the queryCompiler preview feature is enabled in Prisma ORM (v6.7.0+), it does not require Rust engines for CLI tools like `prisma migrate` or `prisma db pull`. The previous understanding that CLI tools would still need Rust binaries even with queryCompiler enabled is incorrect.

content/800-guides/130-docker.mdx (1)

31-40: Minor formatting inconsistency in version specification.

Line 36 has a trailing + after 24.0.0+ that is inconsistent with the version notation above (lines 34-35). Since the >= operator already indicates "and above," the + suffix is redundant. For consistency and clarity, it should read Node.js 24: >= 24.0.0 (without the trailing +).

⛔ Skipped due to learnings

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: Only flag code snippets for (1) exposed secrets with real-looking values that should be placeholders (e.g., API keys, database passwords, AWS credentials), or (2) blatant syntax errors like missing parentheses, brackets, braces, or mismatched delimiters. Do not flag code quality issues, anti-patterns, security vulnerabilities, missing error handling, unused variables, or any other bad practices, as documentation intentionally shows problematic code.

Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:50-66
Timestamp: 2025-10-08T16:22:57.129Z
Learning: In `.mdx` files, do NOT flag or suggest changes for the following code quality issues even if they represent poor practices: React anti-patterns (using var instead of useState, direct DOM manipulation), missing keys in .map() iterations, non-serializable props in getServerSideProps, unused variables, missing error handling, SQL injection vulnerabilities (unless actively showing how to fix them), insecure cookie settings, missing TypeScript types, PrismaClient instantiation patterns, or any other code quality, security, or performance issues. Documentation code snippets are copied from source code and often intentionally show "before" examples or common mistakes.

Learnt from: ankur-arch
Repo: prisma/docs PR: 7066
File: content/200-orm/200-prisma-client/700-debugging-and-troubleshooting/245-troubleshooting-binary-size-issues.mdx:8-22
Timestamp: 2025-08-11T09:40:55.237Z
Learning: When the queryCompiler preview feature is enabled in Prisma ORM (v6.7.0+), it does not require Rust engines for CLI tools like `prisma migrate` or `prisma db pull`. The previous understanding that CLI tools would still need Rust binaries even with queryCompiler enabled is incorrect.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

github-actions · 2025-11-26T20:07:30Z

Dangerous URL check

No absolute URLs to prisma.io/docs found.
No local URLs found.

github-actions · 2025-11-26T20:07:36Z

original	preview
content/200-orm/050-overview/500-databases/800-sql-server/030-sql-server-docker.mdx	content/200-orm/050-overview/500-databases/800-sql-server/030-sql-server-docker.mdx
content/200-orm/200-prisma-client/450-testing/150-integration-testing.mdx	content/200-orm/200-prisma-client/450-testing/150-integration-testing.mdx
content/800-guides/130-docker.mdx	content/800-guides/130-docker.mdx

github-actions · 2025-11-26T20:07:38Z

Redirect check

This PR probably requires the following redirects to be added to static/_redirects:

This PR does not change any pages in a way that would require a redirect.

cloudflare-workers-and-pages · 2025-11-26T20:09:00Z

Deploying docs with Cloudflare Pages

Latest commit:	`ac46076`
Status:	✅ Deploy successful!
Preview URL:	https://d93e944e.docs-51g.pages.dev
Branch Preview URL:	https://dc-6378-docker-version-note.docs-51g.pages.dev

View logs

docker warning added

ac46076

coderabbitai bot approved these changes Nov 26, 2025

View reviewed changes

aidankmcalister requested review from AmanVarshney01, ArthurGamby, ankur-arch, mhartington and mhessdev November 26, 2025 20:14

mhartington approved these changes Nov 26, 2025

View reviewed changes

aidankmcalister merged commit c7c7620 into main Nov 26, 2025
8 checks passed

aidankmcalister deleted the DC-6378-docker-version-note branch November 26, 2025 20:34

coderabbitai bot mentioned this pull request Dec 5, 2025

DC-6313 Version Requirements Updated #7358

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

DC-6378 Docker version warning added#7335

DC-6378 Docker version warning added#7335
aidankmcalister merged 1 commit intomainfrom
DC-6378-docker-version-note

aidankmcalister commented Nov 26, 2025 •

edited by coderabbitai bot

Loading

Uh oh!

coderabbitai bot commented Nov 26, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Nov 26, 2025

Uh oh!

github-actions bot commented Nov 26, 2025

Uh oh!

github-actions bot commented Nov 26, 2025

Uh oh!

cloudflare-workers-and-pages bot commented Nov 26, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

aidankmcalister commented Nov 26, 2025 • edited by coderabbitai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary by CodeRabbit

Uh oh!

coderabbitai bot commented Nov 26, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Estimated code review effort

Possibly related PRs

Pre-merge checks

Uh oh!

github-actions bot commented Nov 26, 2025

Dangerous URL check

Uh oh!

github-actions bot commented Nov 26, 2025

Uh oh!

github-actions bot commented Nov 26, 2025

Redirect check

Uh oh!

cloudflare-workers-and-pages bot commented Nov 26, 2025

Deploying docs with Cloudflare Pages

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

aidankmcalister commented Nov 26, 2025 •

edited by coderabbitai bot

Loading

coderabbitai bot commented Nov 26, 2025 •

edited

Loading