Skip to content

docs: add FAQ entry for checking startup logs in Comfy Desktop#1258

Open
lin-bot23 wants to merge 1 commit into
Comfy-Org:mainfrom
lin-bot23:analytics-fix/2026-07-14-startup-logs-faq
Open

docs: add FAQ entry for checking startup logs in Comfy Desktop#1258
lin-bot23 wants to merge 1 commit into
Comfy-Org:mainfrom
lin-bot23:analytics-fix/2026-07-14-startup-logs-faq

Conversation

@lin-bot23

Copy link
Copy Markdown
Contributor

Summary

Users asking 'how to check startup logs' on the docs homepage could not find relevant information. This adds a dedicated FAQ entry in the Comfy Desktop FAQ explaining how to access startup logs on Windows, macOS, and Linux.

Changes

  • installation/desktop/faq.mdx: added 'How do I check Comfy Desktop startup logs?' accordion in the Troubleshooting section

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

Desktop FAQ updates

Layer / File(s) Summary
Startup logs and uninstall guidance
installation/desktop/faq.mdx
Adds Windows, macOS, and Linux instructions for checking Comfy Desktop startup logs, notes engine-level logs in the instance’s Logs tab, and reformats the uninstall accordion below the new entry.
🚥 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: 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/desktop/faq.mdx`:
- Line 96: Update the Linux entry in the FAQ to include a supported, copyable
launch command or a direct reference to the Linux log location. Keep the
existing real-time logging guidance while making the instruction actionable for
users.
- Around line 85-99: Remove the leading pipe characters from every line inside
the Accordion titled “How do I check Comfy Desktop startup logs?”, including the
platform instructions, code fences, and closing tag, so the content uses normal
MDX/Markdown formatting.
- Around line 100-104: Update the uninstall FAQ accordion content to avoid
claiming the listed steps “fully” remove Comfy Desktop; either change that
wording to “To uninstall the app and installations” or add the documented macOS
cleanup paths and warnings for remaining settings, logs, shared models, and
outputs.
🪄 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: bcbb20f8-c6e3-4f4b-9261-7acb1099db81

📥 Commits

Reviewing files that changed from the base of the PR and between 36378b6 and 1975ab9.

📒 Files selected for processing (1)
  • installation/desktop/faq.mdx

Comment on lines +85 to +99
|<Accordion title="How do I check Comfy Desktop startup logs?">
|When Comfy Desktop fails to start or behaves unexpectedly, you can check the startup logs:
|
|- **Windows:** Open File Explorer and navigate to `%APPDATA%\Comfy-Desktop\logs\`. Look for the most recent `.log` file. You can also run Comfy Desktop from the command line to see real-time output:
| ```powershell
| & "C:\Program Files\Comfy-Desktop\Comfy Desktop.exe"
| ```
|- **macOS:** Open Terminal and run:
| ```bash
| /Applications/Comfy\ Desktop.app/Contents/MacOS/Comfy\ Desktop
| ```
|- **Linux:** Open a terminal and run the app from the command line to see logs in real time
|
|For ComfyUI engine-level logs (not the Desktop app), check the console output when launching a ComfyUI instance from the Desktop app. You can see it in the instance's **Logs** tab.
|</Accordion>

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

Remove the leading | characters from the MDX block.

The new Accordion content is pipe-prefixed, unlike the surrounding Markdown. This can make the block render as pipe-delimited text instead of a normal MDX Accordion. Use unprefixed Markdown/MDX lines.

🤖 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/desktop/faq.mdx` around lines 85 - 99, Remove the leading pipe
characters from every line inside the Accordion titled “How do I check Comfy
Desktop startup logs?”, including the platform instructions, code fences, and
closing tag, so the content uses normal MDX/Markdown formatting.

| ```bash
| /Applications/Comfy\ Desktop.app/Contents/MacOS/Comfy\ Desktop
| ```
|- **Linux:** Open a terminal and run the app from the command line to see logs in real time

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 Linux instructions actionable.

This line tells users to run the app but provides neither an executable command nor a log path. Add the supported Linux launch command or link to the Linux log location.

🤖 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/desktop/faq.mdx` at line 96, Update the Linux entry in the FAQ
to include a supported, copyable launch command or a direct reference to the
Linux log location. Keep the existing real-time logging guidance while making
the instruction actionable for users.

Comment on lines +100 to +104
|<Accordion title="How do I uninstall Comfy Desktop?">
|Comfy Desktop and its installations are separate on disk. To fully remove:
|
|1. **Delete the installations** from within the app (right-click → Remove) or delete the installation folders manually
|2. **Uninstall the app** using your system's standard method (Add/Remove Programs on Windows, drag to Trash on macOS, package manager on Linux)

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

Do not claim this “fully” removes the application yet.

The macOS guide documents that uninstall leaves app settings, logs, shared models, and outputs behind at ~/Library/Application Support/Comfy Desktop and ~/ComfyUI-Shared. Add OS-specific cleanup steps and warnings, or change “To fully remove” to “To uninstall the app and installations.”

🤖 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/desktop/faq.mdx` around lines 100 - 104, Update the uninstall
FAQ accordion content to avoid claiming the listed steps “fully” remove Comfy
Desktop; either change that wording to “To uninstall the app and installations”
or add the documented macOS cleanup paths and warnings for remaining settings,
logs, shared models, and outputs.

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