Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lin-bot23 wants to merge 1 commit into
base: main
Choose a base branch
from
Open

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

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 21 additions & 6 deletions installation/desktop/faq.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -82,9 +82,24 @@ You can browse and restore any snapshot from the app's **Snapshots** section.
- Try taking a manual snapshot first via the app menu
- If the issue persists, restore to a previous snapshot and try again
</Accordion>
<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)
</Accordion>
|<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

@coderabbitai coderabbitai Bot Jul 13, 2026

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.

|
|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>
Comment on lines +85 to +99

@coderabbitai coderabbitai Bot Jul 13, 2026

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.

|<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)
Comment on lines +100 to +104

@coderabbitai coderabbitai Bot Jul 13, 2026

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.

|</Accordion>
Loading