Skip to content

docs: add Docker FAQ note to system requirements page#1230

Merged
comfyui-wiki merged 6 commits into
Comfy-Org:mainfrom
lin-bot23:analytics-fix/2026-07-06-docker-faq
Jul 6, 2026
Merged

docs: add Docker FAQ note to system requirements page#1230
comfyui-wiki merged 6 commits into
Comfy-Org:mainfrom
lin-bot23:analytics-fix/2026-07-06-docker-faq

Conversation

@lin-bot23

Copy link
Copy Markdown
Contributor

Summary
Users frequently ask about Docker installation for ComfyUI (appeared 2+ times in July 5 analytics alone). This PR adds a brief FAQ note to the system requirements page clarifying that no official Docker image is maintained and pointing to community alternatives.

Changes

  • EN: installation/system_requirements.mdx — added Docker FAQ note
  • ZH/JA/KO: synchronized translations

Source
Mintlify AI Assistant analytics data (2026-07-05)

Checklist

  • English + zh/ja/ko updated
  • PR created by Hermes Agent (bot), do not merge

@coderabbitai

coderabbitai Bot commented Jul 5, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@comfyui-wiki, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 51 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 5b3258f7-fbb5-4985-9a48-e41b6823dea3

📥 Commits

Reviewing files that changed from the base of the PR and between fc9877c and dfa3398.

📒 Files selected for processing (5)
  • built-in-nodes/OpenAIGPTImageNodeV2.mdx
  • snippets/install/docker-notice.mdx
  • snippets/ja/install/docker-notice.mdx
  • snippets/ko/install/docker-notice.mdx
  • snippets/zh/install/docker-notice.mdx
📝 Walkthrough

Walkthrough

A documentation update adds localized Docker notices to installation guides and system requirements pages, and introduces reusable Docker notice snippets in English, Japanese, Korean, and Chinese.

Changes

Docker notice documentation

Layer / File(s) Summary
Docker notice snippets
snippets/install/docker-notice.mdx, snippets/ja/install/docker-notice.mdx, snippets/ko/install/docker-notice.mdx, snippets/zh/install/docker-notice.mdx
Adds localized MDX notes stating that ComfyUI has no official Docker image and pointing readers to community-maintained images on Docker Hub.
System requirements pages
installation/system_requirements.mdx, ja/installation/system_requirements.mdx, ko/installation/system_requirements.mdx, zh/installation/system_requirements.mdx
Imports and renders DockerNotice in the FAQ area, and updates translation source hashes where applicable.
Manual install pages
installation/manual_install.mdx, ja/installation/manual_install.mdx, ko/installation/manual_install.mdx, zh/installation/manual_install.mdx
Imports DockerNotice, updates translation source hashes where applicable, and adds new FAQ sections that render the notice near the end of each guide.

Compact metadata: 16 files changed, docs-only, low review effort.

Related issues: None referenced.

Related PRs: None referenced.

Suggested labels: documentation, i18n

Suggested reviewers: None specified

No sequence diagram needed — this change is all docs and no dockside drama.

Poem:
A Docker note now joins the page,
In four tongues it takes the stage.
No official image, community-built —
Clear as day, with zero guilt.

🚥 Pre-merge checks | ✅ 2
✅ Passed checks (2 passed)
Check name Status Explanation
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
✨ Simplify code
  • Create PR with simplified code

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Clarify that ComfyUI has no official Docker image and that images found
on Docker Hub are community-maintained and unsupported. EN/ZH/JA/KO only.
@comfyui-wiki comfyui-wiki force-pushed the analytics-fix/2026-07-06-docker-faq branch from 00bda55 to e102e4b Compare July 6, 2026 01:08
Move the Docker disclaimer into install/docker-notice snippets for EN/ZH/JA/KO
and reference them from system requirements and manual install only.
Place <DockerNotice /> under a localized FAQ heading at the bottom of
system requirements and manual install pages instead of inline.
Refresh translationSourceHash on zh/ja/ko pages and snippet hash comments
after system requirements and manual install changes.
Unescaped <= was parsed as JSX and broke mint broken-links validation.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@installation/manual_install.mdx`:
- Around line 91-93: The shared Docker note rendered by the FAQ block still uses
an em dash, which breaks the English docs style rule. Update the shared snippet
used by DockerNotice so its punctuation is a period, colon, or second sentence
instead of an em dash, and verify the change applies to both English MDX docs
that render this component.

In `@installation/system_requirements.mdx`:
- Around line 66-69: The shared Docker notice rendered by the FAQ block uses
punctuation that violates the English MDX style guide. Update the shared snippet
used by DockerNotice so its sentence ends with a period or colon instead of an
em dash, and keep the change in the reusable copy rather than the page-specific
FAQ content.

In `@snippets/install/docker-notice.mdx`:
- Line 2: The Docker notice text in the MDX snippet uses an em dash, which
violates the English documentation style guide. Update the sentence in the
docker notice content to remove the em dash and split it into separate sentences
or use punctuation like a period or colon, keeping the wording associated with
the Docker notice message intact.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: fd69ab09-62f5-4f46-9766-31611365a346

📥 Commits

Reviewing files that changed from the base of the PR and between 70e2a6c and fc9877c.

📒 Files selected for processing (12)
  • installation/manual_install.mdx
  • installation/system_requirements.mdx
  • ja/installation/manual_install.mdx
  • ja/installation/system_requirements.mdx
  • ko/installation/manual_install.mdx
  • ko/installation/system_requirements.mdx
  • snippets/install/docker-notice.mdx
  • snippets/ja/install/docker-notice.mdx
  • snippets/ko/install/docker-notice.mdx
  • snippets/zh/install/docker-notice.mdx
  • zh/installation/manual_install.mdx
  • zh/installation/system_requirements.mdx

Comment on lines +91 to +93
## FAQ

<DockerNotice />

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Keep the Docker note punctuation compliant.

This FAQ block renders the same shared English Docker note, so the em dash shows up here too. Please swap it for a period or colon in the shared snippet so both English docs stay within the style guide. As per coding guidelines, **/*.mdx: In English documentation, avoid em dashes (—); use periods, commas, colons, parentheses, or a second sentence instead.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@installation/manual_install.mdx` around lines 91 - 93, The shared Docker note
rendered by the FAQ block still uses an em dash, which breaks the English docs
style rule. Update the shared snippet used by DockerNotice so its punctuation is
a period, colon, or second sentence instead of an em dash, and verify the change
applies to both English MDX docs that render this component.

Source: Coding guidelines

Comment on lines +66 to +69

## FAQ

<DockerNotice />

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Keep the Docker note punctuation compliant.

This FAQ block renders the shared English Docker note, and that copy uses an em dash. Please swap it for a period or colon in the shared snippet so the rendered docs stay within the English MDX style guide. As per coding guidelines, **/*.mdx: In English documentation, avoid em dashes (—); use periods, commas, colons, parentheses, or a second sentence instead.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@installation/system_requirements.mdx` around lines 66 - 69, The shared Docker
notice rendered by the FAQ block uses punctuation that violates the English MDX
style guide. Update the shared snippet used by DockerNotice so its sentence ends
with a period or colon instead of an em dash, and keep the change in the
reusable copy rather than the page-specific FAQ content.

Source: Coding guidelines

Comment thread snippets/install/docker-notice.mdx Outdated
Split the English Docker notice into separate sentences to match the
English MDX style guide. Refresh snippet translation hashes.
@comfyui-wiki comfyui-wiki merged commit c38f8c4 into Comfy-Org:main Jul 6, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants