Skip to content

docs: improve Docker notice with setup steps and example command#1259

Open
lin-bot23 wants to merge 1 commit into
Comfy-Org:mainfrom
lin-bot23:analytics-fix/2026-07-14-docker-notice-improvement
Open

docs: improve Docker notice with setup steps and example command#1259
lin-bot23 wants to merge 1 commit into
Comfy-Org:mainfrom
lin-bot23:analytics-fix/2026-07-14-docker-notice-improvement

Conversation

@lin-bot23

Copy link
Copy Markdown
Contributor

Summary

Multiple users asked about Docker installation on the docs homepage and installation pages. The existing Docker notice was too vague ('search Docker Hub') and did not provide actionable guidance. This update adds specific search terms, common setup steps (port mapping, volume mounts), and a Docker run command example.

Changes

  • snippets/install/docker-notice.mdx: expanded the Docker notice with search terms, setup steps, and a docker run example

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

Checklist

  • English only (translations separate)
  • PR created by Hermes Agent (bot), do not merge

@coderabbitai

coderabbitai Bot commented Jul 13, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Changes

Docker notice guidance

Layer / File(s) Summary
Community image setup guidance
snippets/install/docker-notice.mdx
Adds common port and volume mappings, a docker run example, and a disclaimer that community images are not official or supported by the ComfyUI team. A handy container tip, ship-shape.

Possibly related PRs

  • Comfy-Org/docs#1230: Imports the shared Docker notice snippet into system requirements and manual installation documentation.
🚥 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.

@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: 1

🤖 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 `@snippets/install/docker-notice.mdx`:
- Around line 11-16: Update the Docker example in the installation notice to use
container volume paths specific to the documented community image, or clearly
instruct users to replace /ComfyUI/models and /ComfyUI/output with the paths
required by their selected image. Ensure the example’s mounts target directories
the named image actually uses.
🪄 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: 9f3b3b55-8630-4716-b5c4-fafef2ebf14f

📥 Commits

Reviewing files that changed from the base of the PR and between 36378b6 and 5139ac5.

📒 Files selected for processing (1)
  • snippets/install/docker-notice.mdx

Comment on lines +11 to +16
docker run -d \
--name comfyui \
-p 8188:8188 \
-v /path/to/models:/ComfyUI/models \
-v /path/to/output:/ComfyUI/output \
<community-image-name>

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

Make the volume paths image-specific.

Community images do not share one container layout. For example, one current image uses /opt/comfyui/models and /opt/comfyui/output, so this command may mount directories that the selected image never reads or writes. A mount that misses its target is just a decorative bind. Document paths for a named image, or explicitly instruct users to replace the container paths according to that image’s documentation. (github.com)

🤖 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 `@snippets/install/docker-notice.mdx` around lines 11 - 16, Update the Docker
example in the installation notice to use container volume paths specific to the
documented community image, or clearly instruct users to replace /ComfyUI/models
and /ComfyUI/output with the paths required by their selected image. Ensure the
example’s mounts target directories the named image actually uses.

Source: MCP tools

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.

1 participant