[GH-ISSUE #1576] [Bug]: MacOS Desktop APP doesn't lunch after install, comfyui setup 0.8.0-arm64.dmg! Macbook pro M5, latest MacOS version！ #466

New issue

Closed

opened 2026-10-31 22:13:21 +00:00 by bsakaguchi · 3 comments

bsakaguchi commented 2026-10-31 22:13:21 +00:00

Owner

Copy link

Originally created by @starwishzzgg on GitHub (Jan 31, 2026).
Original GitHub issue: https://github.com/Comfy-Org/desktop/issues/1576

App Version

comfyui setup 0.8.0-arm64.dmg

Expected Behavior

Lunch correctly and show the guide.

Actual Behavior

MacOS Desktop APP doesn't lunch after install.

Steps to Reproduce

1,download the dmg from "https://www.comfy.org/zh-cn/download"
2,double click the dmg file
3,Drag the ComfyUI icon to the Applications folder
4,find the comfyui icon in APP folder and double click it
5,cannot lunch.

Debug Logs

Browser Logs

No response

Settings JSON

No response

Other

No response

┆Issue is synchronized with this Notion page by Unito

Originally created by @starwishzzgg on GitHub (Jan 31, 2026). Original GitHub issue: https://github.com/Comfy-Org/desktop/issues/1576 ### App Version comfyui setup 0.8.0-arm64.dmg ### Expected Behavior Lunch correctly and show the guide. ### Actual Behavior MacOS Desktop APP doesn't lunch after install. ### Steps to Reproduce 1,download the dmg from "https://www.comfy.org/zh-cn/download" 2,double click the dmg file 3,Drag the ComfyUI icon to the Applications folder 4,find the comfyui icon in APP folder and double click it 5,cannot lunch. ### Debug Logs ```powershell ``` ### Browser Logs _No response_ ### Settings JSON _No response_ ### Other _No response_ ┆Issue is synchronized with this [Notion page](https://www.notion.so/Issue-1576-Bug-MacOS-Desktop-APP-doesn-t-lunch-after-install-comfyui-setup-0-8-0-arm64-dmg-2f96d73d365081628ba0f184cd97506f) by [Unito](https://www.unito.io)

bsakaguchi 2026-10-31 22:13:21 +00:00

• closed this issue
• added the
  bug
  Potential Bug
  labels

bsakaguchi commented 2026-10-31 22:13:21 +00:00

Author

Owner

Copy link

@dosubot[bot] commented on GitHub (Jan 31, 2026):

Hi @starwishzzgg! I'm Dosu and I’m helping the desktop team.

The most common reasons the MacOS ARM64 desktop app doesn't launch are: system incompatibility, missing dependencies, network issues during setup, permission problems, or database initialization failures. Here’s a step-by-step guide to troubleshoot:

1. Check compatibility: Make sure you’re on an Apple Silicon Mac (M1/M2/M3) and your macOS version is supported. If the app icon shows a prohibition sign, your system version isn’t compatible docs.

2. Reset the Python environment: Go to your ComfyUI installation directory, delete the .venv folder, and relaunch the app. This forces a rebuild of the environment and often resolves launch issues issue.

3. Manual dependency install: If the app still doesn’t launch, open Terminal, activate the virtual environment, and run:

   cd /path/to/your/ComfyUI
   source .venv/bin/activate
   uv pip install -r /Applications/ComfyUI.app/Contents/Resources/ComfyUI/requirements.txt
   

   This fixes incomplete setups issue.

4. Check permissions: Ensure your install and user directories (like ~/Documents/ComfyUI/user) have read/write permissions issue.

5. Database path issue: If you see errors about failing to open the database file, the app may be trying to write to a read-only path inside the app bundle. You can work around this by configuring the backend launch arguments to use a writable path (see Comfy.Server.LaunchArgs in the app config) issue.

6. Network problems: The app needs to download Python and dependencies during setup. If you’re in a region with restricted access to GitHub, select a download mirror during installation or try a clean uninstall/reinstall docs, issue.

7. Logs for diagnosis: Check main.log (Electron process) and comfyui.log (core ComfyUI) in your install or user directory for error messages. You can also launch the app from Terminal to see real-time output docs.

If none of these steps work, a full uninstall and reinstall (with a clean, empty install directory and stable network) is recommended docs. If you get specific error messages or logs, share them for more targeted help.

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.

<!-- gh-comment-id:3828594128 --> @dosubot[bot] commented on GitHub (Jan 31, 2026): <!-- Greeting --> Hi @starwishzzgg! I'm [Dosu](https://go.dosu.dev/dosubot) and I’m helping the desktop team. <!-- Answer --> The most common reasons the MacOS ARM64 desktop app doesn't launch are: system incompatibility, missing dependencies, network issues during setup, permission problems, or database initialization failures. Here’s a step-by-step guide to troubleshoot: 1. **Check compatibility**: Make sure you’re on an Apple Silicon Mac (M1/M2/M3) and your macOS version is supported. If the app icon shows a prohibition sign, your system version isn’t compatible [docs](https://docs.comfy.org/installation/desktop/macos). 2. **Reset the Python environment**: Go to your ComfyUI installation directory, delete the `.venv` folder, and relaunch the app. This forces a rebuild of the environment and often resolves launch issues [issue](https://github.com/Comfy-Org/desktop/issues/560). 3. **Manual dependency install**: If the app still doesn’t launch, open Terminal, activate the virtual environment, and run: ```bash cd /path/to/your/ComfyUI source .venv/bin/activate uv pip install -r /Applications/ComfyUI.app/Contents/Resources/ComfyUI/requirements.txt ``` This fixes incomplete setups [issue](https://github.com/Comfy-Org/desktop/issues/560). 4. **Check permissions**: Ensure your install and user directories (like `~/Documents/ComfyUI/user`) have read/write permissions [issue](https://github.com/Comfy-Org/desktop/issues/1478). 5. **Database path issue**: If you see errors about failing to open the database file, the app may be trying to write to a read-only path inside the app bundle. You can work around this by configuring the backend launch arguments to use a writable path (see `Comfy.Server.LaunchArgs` in the app config) [issue](https://github.com/Comfy-Org/desktop/issues/1532). 6. **Network problems**: The app needs to download Python and dependencies during setup. If you’re in a region with restricted access to GitHub, select a download mirror during installation or try a clean uninstall/reinstall [docs](https://docs.comfy.org/zh-CN/installation/desktop/macos), [issue](https://github.com/Comfy-Org/desktop/issues/836). 7. **Logs for diagnosis**: Check `main.log` (Electron process) and `comfyui.log` (core ComfyUI) in your install or user directory for error messages. You can also launch the app from Terminal to see real-time output [docs](https://docs.comfy.org/installation/desktop/macos). If none of these steps work, a full uninstall and reinstall (with a clean, empty install directory and stable network) is recommended [docs](https://docs.comfy.org/installation/desktop/macos). If you get specific error messages or logs, share them for more targeted help. <!-- Dosu Comment Footer --> *To reply, just mention [@dosu](https://go.dosu.dev/dosubot?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=reply-with-mention&utm_term=Comfy-Org%2Fdesktop).* --- Docs are dead. Just use [Dosu](https://dosu.dev?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=static-docs-tagline&utm_term=Comfy-Org%2Fdesktop). [](https://app.dosu.dev/response-feedback?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=static-docs-feedback&utm_term=Comfy-Org%2Fdesktop#message_id=db9606b7-12d7-4471-9931-6f9114716aa9) [](https://github.dosu.com/Comfy-Org/desktop?utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=static-docs-ask-repo&utm_term=Comfy-Org%2Fdesktop) [](https://app.dosu.dev/signup?referrer=openSource&source=github-footer&utm_source=github&utm_medium=bot-comment&utm_campaign=github-comment-footer-20260415&utm_content=static-docs-share-team&utm_term=Comfy-Org%2Fdesktop)

bsakaguchi commented 2026-10-31 22:13:21 +00:00

Author

Owner

Copy link

@starwishzzgg commented on GitHub (Jan 31, 2026):

Hi @starwishzzgg! I'm Dosu and I’m helping the desktop team.

The most common reasons the MacOS ARM64 desktop app doesn't launch are: system incompatibility, missing dependencies, network issues during setup, permission problems, or database initialization failures. Here’s a step-by-step guide to troubleshoot:

1. Check compatibility: Make sure you’re on an Apple Silicon Mac (M1/M2/M3) and your macOS version is supported. If the app icon shows a prohibition sign, your system version isn’t compatible docs.

2. Reset the Python environment: Go to your ComfyUI installation directory, delete the .venv folder, and relaunch the app. This forces a rebuild of the environment and often resolves launch issues issue.

3. Manual dependency install: If the app still doesn’t launch, open Terminal, activate the virtual environment, and run:
   cd /path/to/your/ComfyUI
   source .venv/bin/activate
   uv pip install -r /Applications/ComfyUI.app/Contents/Resources/ComfyUI/requirements.txt

   This fixes incomplete setups issue.

4. Check permissions: Ensure your install and user directories (like ~/Documents/ComfyUI/user) have read/write permissions issue.

5. Database path issue: If you see errors about failing to open the database file, the app may be trying to write to a read-only path inside the app bundle. You can work around this by configuring the backend launch arguments to use a writable path (see Comfy.Server.LaunchArgs in the app config) issue.

6. Network problems: The app needs to download Python and dependencies during setup. If you’re in a region with restricted access to GitHub, select a download mirror during installation or try a clean uninstall/reinstall docs, issue.

7. Logs for diagnosis: Check main.log (Electron process) and comfyui.log (core ComfyUI) in your install or user directory for error messages. You can also launch the app from Terminal to see real-time output docs.

If none of these steps work, a full uninstall and reinstall (with a clean, empty install directory and stable network) is recommended docs. If you get specific error messages or logs, share them for more targeted help.

To reply, just mention @dosu.

How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other

   

<!-- gh-comment-id:3828737855 --> @starwishzzgg commented on GitHub (Jan 31, 2026): > Hi [@starwishzzgg](https://github.com/starwishzzgg)! I'm [Dosu](https://go.dosu.dev/dosubot) and I’m helping the desktop team. > > The most common reasons the MacOS ARM64 desktop app doesn't launch are: system incompatibility, missing dependencies, network issues during setup, permission problems, or database initialization failures. Here’s a step-by-step guide to troubleshoot: > > 1. **Check compatibility**: Make sure you’re on an Apple Silicon Mac (M1/M2/M3) and your macOS version is supported. If the app icon shows a prohibition sign, your system version isn’t compatible [docs](https://docs.comfy.org/installation/desktop/macos). > 2. **Reset the Python environment**: Go to your ComfyUI installation directory, delete the `.venv` folder, and relaunch the app. This forces a rebuild of the environment and often resolves launch issues [issue](https://github.com/Comfy-Org/desktop/issues/560). > 3. **Manual dependency install**: If the app still doesn’t launch, open Terminal, activate the virtual environment, and run: > cd /path/to/your/ComfyUI > source .venv/bin/activate > uv pip install -r /Applications/ComfyUI.app/Contents/Resources/ComfyUI/requirements.txt > > > > > > > > > > This fixes incomplete setups [issue](https://github.com/Comfy-Org/desktop/issues/560). > 4. **Check permissions**: Ensure your install and user directories (like `~/Documents/ComfyUI/user`) have read/write permissions [issue](https://github.com/Comfy-Org/desktop/issues/1478). > 5. **Database path issue**: If you see errors about failing to open the database file, the app may be trying to write to a read-only path inside the app bundle. You can work around this by configuring the backend launch arguments to use a writable path (see `Comfy.Server.LaunchArgs` in the app config) [issue](https://github.com/Comfy-Org/desktop/issues/1532). > 6. **Network problems**: The app needs to download Python and dependencies during setup. If you’re in a region with restricted access to GitHub, select a download mirror during installation or try a clean uninstall/reinstall [docs](https://docs.comfy.org/zh-CN/installation/desktop/macos), [issue](https://github.com/Comfy-Org/desktop/issues/836). > 7. **Logs for diagnosis**: Check `main.log` (Electron process) and `comfyui.log` (core ComfyUI) in your install or user directory for error messages. You can also launch the app from Terminal to see real-time output [docs](https://docs.comfy.org/installation/desktop/macos). > > If none of these steps work, a full uninstall and reinstall (with a clean, empty install directory and stable network) is recommended [docs](https://docs.comfy.org/installation/desktop/macos). If you get specific error messages or logs, share them for more targeted help. > > _To reply, just mention [@dosu](https://go.dosu.dev/dosubot)._ > > How did I do? [Good](https://app.dosu.dev/response-feedback/db9606b7-12d7-4471-9931-6f9114716aa9?feedback_type=great_response) | [Irrelevant](https://app.dosu.dev/response-feedback/db9606b7-12d7-4471-9931-6f9114716aa9?feedback_type=irrelevant_answer) | [Incorrect](https://app.dosu.dev/response-feedback/db9606b7-12d7-4471-9931-6f9114716aa9?feedback_type=incorrect_sources) | [Verbose](https://app.dosu.dev/response-feedback/db9606b7-12d7-4471-9931-6f9114716aa9?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/db9606b7-12d7-4471-9931-6f9114716aa9?feedback_type=hallucination) | [Report 🐛](https://app.dosu.dev/response-feedback/db9606b7-12d7-4471-9931-6f9114716aa9?feedback_type=bug_report) | [Other](https://app.dosu.dev/response-feedback/db9606b7-12d7-4471-9931-6f9114716aa9?feedback_type=other) > > [](https://app.dosu.dev/b5ba5ada-382a-44fa-8252-24bddb1098d9/ask?utm_source=github) [](https://cursor.com/link/prompt?text=The%20most%20common%20reasons%20the%20MacOS%20ARM64%20desktop%20app%20doesn%27t%20launch%20are%3A%20system%20incompatibility%2C%20missing%20dependencies%2C%20network%20issues%20during%20setup%2C%20permission%20problems%2C%20or%20database%20initialization%20failures.%20Here%E2%80%99s%20a%20step-by-step%20guide%20to%20troubleshoot%3A%0A%0A1.%20%2A%2ACheck%20compatibility%2A%2A%3A%20Make%20sure%20you%E2%80%99re%20on%20an%20Apple%20Silicon%20Mac%20%28M1/M2/M3%29%20and%20your%20macOS%20version%20is%20supported.%20If%20the%20app%20icon%20shows%20a%20prohibition%20sign%2C%20your%20system%20version%20isn%E2%80%99t%20compatible%C2%A0%5Bdocs%5D%28https%3A//docs.comfy.org/installation/desktop/macos%29.%0A%0A2.%20%2A%2AReset%20the%20Python%20environment%2A%2A%3A%20Go%20to%20your%20ComfyUI%20installation%20directory%2C%20delete%20the%20%60.venv%60%20folder%2C%20and%20relaunch%20the%20app.%20This%20forces%20a%20rebuild%20of%20the%20environment%20and%20often%20resolves%20launch%20issues%C2%A0%5Bissue%5D%28https%3A//github.com/Comfy-Org/desktop/issues/560%29.%0A%0A3.%20%2A%2AManual%20dependency%20install%2A%2A%3A%20If%20the%20app%20still%20doesn%E2%80%99t%20launch%2C%20open%20Terminal%2C%20activate%20the%20virtual%20environment%2C%20and%20run%3A%0A%20%20%20%60%60%60bash%0A%20%20%20cd%20/path/to/your/ComfyUI%0A%20%20%20source%20.venv/bin/activate%0A%20%20%20uv%20pip%20install%20-r%20/Applications/ComfyUI.app/Contents/Resources/ComfyUI/requirements.txt%0A%20%20%20%60%60%60%0A%20%20%20This%20fixes%20incomplete%20setups%C2%A0%5Bissue%5D%28https%3A//github.com/Comfy-Org/desktop/issues/560%29.%0A%0A4.%20%2A%2ACheck%20permissions%2A%2A%3A%20Ensure%20your%20install%20and%20user%20directories%20%28like%20%60~/Documents/ComfyUI/user%60%29%20have%20read/write%20permissions%C2%A0%5Bissue%5D%28https%3A//github.com/Comfy-Org/desktop/issues/1478%29.%0A%0A5.%20%2A%2ADatabase%20path%20issue%2A%2A%3A%20If%20you%20see%20errors%20about%20failing%20to%20open%20the%20database%20file%2C%20the%20app%20may%20be%20trying%20to%20write%20to%20a%20read-only%20path%20inside%20the%20app%20bundle.%20You%20can%20work%20around%20this%20by%20configuring%20the%20backend%20launch%20arguments%20to%20use%20a%20writable%20path%20%28see%20%60Comfy.Server.LaunchArgs%60%20in%20the%20app%20config%29%C2%A0%5Bissue%5D%28https%3A//github.com/Comfy-Org/desktop/issues/1532%29.%0A%0A6.%20%2A%2ANetwork%20problems%2A%2A%3A%20The%20app%20needs%20to%20download%20Python%20and%20dependencies%20during%20setup.%20If%20you%E2%80%99re%20in%20a%20region%20with%20restricted%20access%20to%20GitHub%2C%20select%20a%20download%20mirror%20during%20installation%20or%20try%20a%20clean%20uninstall/reinstall%C2%A0%5Bdocs%5D%28https%3A//docs.comfy.org/zh-CN/installation/desktop/macos%29%2C%C2%A0%5Bissue%5D%28https%3A//github.com/Comfy-Org/desktop/issues/836%29.%0A%0A7.%20%2A%2ALogs%20for%20diagnosis%2A%2A%3A%20Check%20%60main.log%60%20%28Electron%20process%29%20and%20%60comfyui.log%60%20%28core%20ComfyUI%29%20in%20your%20install%20or%20user%20directory%20for%20error%20messages.%20You%20can%20also%20launch%20the%20app%20from%20Terminal%20to%20see%20real-time%20output%C2%A0%5Bdocs%5D%28https%3A//docs.comfy.org/installation/desktop/macos%29.%0A%0AIf%20none%20of%20these%20steps%20work%2C%20a%20full%20uninstall%20and%20reinstall%20%28with%20a%20clean%2C%20empty%20install%20directory%20and%20stable%20network%29%20is%20recommended%C2%A0%5Bdocs%5D%28https%3A//docs.comfy.org/installation/desktop/macos%29.%20If%20you%20get%20specific%20error%20messages%20or%20logs%2C%20share%20them%20for%20more%20targeted%20help.) [](https://go.dosu.dev/discord-bot) [](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/Comfy-Org/desktop/issues/1576)

bsakaguchi commented 2026-10-31 22:13:22 +00:00

Author

Owner

Copy link

@starwishzzgg commented on GitHub (Jan 31, 2026):

Hi @starwishzzgg! I'm Dosu and I’m helping the desktop team.
The most common reasons the MacOS ARM64 desktop app doesn't launch are: system incompatibility, missing dependencies, network issues during setup, permission problems, or database initialization failures. Here’s a step-by-step guide to troubleshoot:

1. Check compatibility: Make sure you’re on an Apple Silicon Mac (M1/M2/M3) and your macOS version is supported. If the app icon shows a prohibition sign, your system version isn’t compatible docs.
2. Reset the Python environment: Go to your ComfyUI installation directory, delete the .venv folder, and relaunch the app. This forces a rebuild of the environment and often resolves launch issues issue.
3. Manual dependency install: If the app still doesn’t launch, open Terminal, activate the virtual environment, and run:
   cd /path/to/your/ComfyUI
   source .venv/bin/activate
   uv pip install -r /Applications/ComfyUI.app/Contents/Resources/ComfyUI/requirements.txt
   This fixes incomplete setups issue.
4. Check permissions: Ensure your install and user directories (like ~/Documents/ComfyUI/user) have read/write permissions issue.
5. Database path issue: If you see errors about failing to open the database file, the app may be trying to write to a read-only path inside the app bundle. You can work around this by configuring the backend launch arguments to use a writable path (see Comfy.Server.LaunchArgs in the app config) issue.
6. Network problems: The app needs to download Python and dependencies during setup. If you’re in a region with restricted access to GitHub, select a download mirror during installation or try a clean uninstall/reinstall docs, issue.
7. Logs for diagnosis: Check main.log (Electron process) and comfyui.log (core ComfyUI) in your install or user directory for error messages. You can also launch the app from Terminal to see real-time output docs.

If none of these steps work, a full uninstall and reinstall (with a clean, empty install directory and stable network) is recommended docs. If you get specific error messages or logs, share them for more targeted help.
To reply, just mention @dosu.
How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other
   

there is no comfyui folder,because I haven't finished the installation, so your all resolution won't work.

I closed the issue by mistake, please help me to change the status to open...

<!-- gh-comment-id:3828741731 --> @starwishzzgg commented on GitHub (Jan 31, 2026): > > Hi [@starwishzzgg](https://github.com/starwishzzgg)! I'm [Dosu](https://go.dosu.dev/dosubot) and I’m helping the desktop team. > > The most common reasons the MacOS ARM64 desktop app doesn't launch are: system incompatibility, missing dependencies, network issues during setup, permission problems, or database initialization failures. Here’s a step-by-step guide to troubleshoot: > > > > 1. **Check compatibility**: Make sure you’re on an Apple Silicon Mac (M1/M2/M3) and your macOS version is supported. If the app icon shows a prohibition sign, your system version isn’t compatible [docs](https://docs.comfy.org/installation/desktop/macos). > > 2. **Reset the Python environment**: Go to your ComfyUI installation directory, delete the `.venv` folder, and relaunch the app. This forces a rebuild of the environment and often resolves launch issues [issue](https://github.com/Comfy-Org/desktop/issues/560). > > 3. **Manual dependency install**: If the app still doesn’t launch, open Terminal, activate the virtual environment, and run: > > cd /path/to/your/ComfyUI > > source .venv/bin/activate > > uv pip install -r /Applications/ComfyUI.app/Contents/Resources/ComfyUI/requirements.txt > > This fixes incomplete setups [issue](https://github.com/Comfy-Org/desktop/issues/560). > > 4. **Check permissions**: Ensure your install and user directories (like `~/Documents/ComfyUI/user`) have read/write permissions [issue](https://github.com/Comfy-Org/desktop/issues/1478). > > 5. **Database path issue**: If you see errors about failing to open the database file, the app may be trying to write to a read-only path inside the app bundle. You can work around this by configuring the backend launch arguments to use a writable path (see `Comfy.Server.LaunchArgs` in the app config) [issue](https://github.com/Comfy-Org/desktop/issues/1532). > > 6. **Network problems**: The app needs to download Python and dependencies during setup. If you’re in a region with restricted access to GitHub, select a download mirror during installation or try a clean uninstall/reinstall [docs](https://docs.comfy.org/zh-CN/installation/desktop/macos), [issue](https://github.com/Comfy-Org/desktop/issues/836). > > 7. **Logs for diagnosis**: Check `main.log` (Electron process) and `comfyui.log` (core ComfyUI) in your install or user directory for error messages. You can also launch the app from Terminal to see real-time output [docs](https://docs.comfy.org/installation/desktop/macos). > > > > If none of these steps work, a full uninstall and reinstall (with a clean, empty install directory and stable network) is recommended [docs](https://docs.comfy.org/installation/desktop/macos). If you get specific error messages or logs, share them for more targeted help. > > _To reply, just mention [@dosu](https://go.dosu.dev/dosubot)._ > > How did I do? [Good](https://app.dosu.dev/response-feedback/db9606b7-12d7-4471-9931-6f9114716aa9?feedback_type=great_response) | [Irrelevant](https://app.dosu.dev/response-feedback/db9606b7-12d7-4471-9931-6f9114716aa9?feedback_type=irrelevant_answer) | [Incorrect](https://app.dosu.dev/response-feedback/db9606b7-12d7-4471-9931-6f9114716aa9?feedback_type=incorrect_sources) | [Verbose](https://app.dosu.dev/response-feedback/db9606b7-12d7-4471-9931-6f9114716aa9?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/db9606b7-12d7-4471-9931-6f9114716aa9?feedback_type=hallucination) | [Report 🐛](https://app.dosu.dev/response-feedback/db9606b7-12d7-4471-9931-6f9114716aa9?feedback_type=bug_report) | [Other](https://app.dosu.dev/response-feedback/db9606b7-12d7-4471-9931-6f9114716aa9?feedback_type=other) > > [](https://app.dosu.dev/b5ba5ada-382a-44fa-8252-24bddb1098d9/ask?utm_source=github) [](https://cursor.com/link/prompt?text=The%20most%20common%20reasons%20the%20MacOS%20ARM64%20desktop%20app%20doesn%27t%20launch%20are%3A%20system%20incompatibility%2C%20missing%20dependencies%2C%20network%20issues%20during%20setup%2C%20permission%20problems%2C%20or%20database%20initialization%20failures.%20Here%E2%80%99s%20a%20step-by-step%20guide%20to%20troubleshoot%3A%0A%0A1.%20%2A%2ACheck%20compatibility%2A%2A%3A%20Make%20sure%20you%E2%80%99re%20on%20an%20Apple%20Silicon%20Mac%20%28M1/M2/M3%29%20and%20your%20macOS%20version%20is%20supported.%20If%20the%20app%20icon%20shows%20a%20prohibition%20sign%2C%20your%20system%20version%20isn%E2%80%99t%20compatible%C2%A0%5Bdocs%5D%28https%3A//docs.comfy.org/installation/desktop/macos%29.%0A%0A2.%20%2A%2AReset%20the%20Python%20environment%2A%2A%3A%20Go%20to%20your%20ComfyUI%20installation%20directory%2C%20delete%20the%20%60.venv%60%20folder%2C%20and%20relaunch%20the%20app.%20This%20forces%20a%20rebuild%20of%20the%20environment%20and%20often%20resolves%20launch%20issues%C2%A0%5Bissue%5D%28https%3A//github.com/Comfy-Org/desktop/issues/560%29.%0A%0A3.%20%2A%2AManual%20dependency%20install%2A%2A%3A%20If%20the%20app%20still%20doesn%E2%80%99t%20launch%2C%20open%20Terminal%2C%20activate%20the%20virtual%20environment%2C%20and%20run%3A%0A%20%20%20%60%60%60bash%0A%20%20%20cd%20/path/to/your/ComfyUI%0A%20%20%20source%20.venv/bin/activate%0A%20%20%20uv%20pip%20install%20-r%20/Applications/ComfyUI.app/Contents/Resources/ComfyUI/requirements.txt%0A%20%20%20%60%60%60%0A%20%20%20This%20fixes%20incomplete%20setups%C2%A0%5Bissue%5D%28https%3A//github.com/Comfy-Org/desktop/issues/560%29.%0A%0A4.%20%2A%2ACheck%20permissions%2A%2A%3A%20Ensure%20your%20install%20and%20user%20directories%20%28like%20%60~/Documents/ComfyUI/user%60%29%20have%20read/write%20permissions%C2%A0%5Bissue%5D%28https%3A//github.com/Comfy-Org/desktop/issues/1478%29.%0A%0A5.%20%2A%2ADatabase%20path%20issue%2A%2A%3A%20If%20you%20see%20errors%20about%20failing%20to%20open%20the%20database%20file%2C%20the%20app%20may%20be%20trying%20to%20write%20to%20a%20read-only%20path%20inside%20the%20app%20bundle.%20You%20can%20work%20around%20this%20by%20configuring%20the%20backend%20launch%20arguments%20to%20use%20a%20writable%20path%20%28see%20%60Comfy.Server.LaunchArgs%60%20in%20the%20app%20config%29%C2%A0%5Bissue%5D%28https%3A//github.com/Comfy-Org/desktop/issues/1532%29.%0A%0A6.%20%2A%2ANetwork%20problems%2A%2A%3A%20The%20app%20needs%20to%20download%20Python%20and%20dependencies%20during%20setup.%20If%20you%E2%80%99re%20in%20a%20region%20with%20restricted%20access%20to%20GitHub%2C%20select%20a%20download%20mirror%20during%20installation%20or%20try%20a%20clean%20uninstall/reinstall%C2%A0%5Bdocs%5D%28https%3A//docs.comfy.org/zh-CN/installation/desktop/macos%29%2C%C2%A0%5Bissue%5D%28https%3A//github.com/Comfy-Org/desktop/issues/836%29.%0A%0A7.%20%2A%2ALogs%20for%20diagnosis%2A%2A%3A%20Check%20%60main.log%60%20%28Electron%20process%29%20and%20%60comfyui.log%60%20%28core%20ComfyUI%29%20in%20your%20install%20or%20user%20directory%20for%20error%20messages.%20You%20can%20also%20launch%20the%20app%20from%20Terminal%20to%20see%20real-time%20output%C2%A0%5Bdocs%5D%28https%3A//docs.comfy.org/installation/desktop/macos%29.%0A%0AIf%20none%20of%20these%20steps%20work%2C%20a%20full%20uninstall%20and%20reinstall%20%28with%20a%20clean%2C%20empty%20install%20directory%20and%20stable%20network%29%20is%20recommended%C2%A0%5Bdocs%5D%28https%3A//docs.comfy.org/installation/desktop/macos%29.%20If%20you%20get%20specific%20error%20messages%20or%20logs%2C%20share%20them%20for%20more%20targeted%20help.) [](https://go.dosu.dev/discord-bot) [](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/Comfy-Org/desktop/issues/1576) there is no comfyui folder,because I haven't finished the installation, so your all resolution won't work. I closed the issue by mistake, please help me to change the status to open...

bsakaguchi referenced this issue 2026-10-31 22:17:45 +00:00

[PR #466] enh: Add Check For Updates button #888

Sign in to join this conversation.

No Branch/Tag specified

Branches Tags

main

chore/archive-notice

deepme987/desktop/deprecation-banner

bl/bump-comfyui-0-22-3

add-comfy-environment-marker

bl/missing-model-download-contract

bl/bump-comfyui-0.20.2

sno-proxysettings

bl/missing-model-download-ui-consume-fix

bl/missing-model-download-ui-test

feat/deep-link-protocol-handler

ben/oem-machine-scope-install-state

bl/fix-missing-model-download-path-e2e

bump-workflow-templates

chore/example-pr-close

chore/bump-frontend-1.39.19-r2

fix/frontend-optional-branch-core-1-39

fwra

chore/frontend-override-backport-9185-core-1.39

bump-comfyui-v0.15.0-package-json-only

ben/auto-bump-comfyui-release-optional-main-commit

bump-uv-v0.10.4-and-macos-resolution

ben/auto-bump-comfyui-release

fix/sentry-gpu-driver-reporting

fix/close-confirmation-ipc

fix/desktop-frontend-sourcemaps

revert-1565-chore/pytorch-2-10

chore/deps-rollup-2026-01-29

fix/macos-torch-index

fix/disable-forced-pytorch-upgrade

fix/rename-upgrade-packages-to-needs-package-update

fix/venv-troubleshooting-e2e

update-comfyui-core-0.9.2

torch-update-prompt

issue-1534-nvidia-driver-warning

revert-core-comfyui-0-9-1

bl-canary-release

bl-flaky-version-mask

chore/pytorch-2.9.1-cu130

bl-fix-amd-aarch-warning

bl-shaggy-urial

fix-todesktop-workflow

fix/self-heal-missing-dirs

bl-aggregate-ape

bl-interesting-warbler

bl-dramatic-opossum

bl-northern-whippet

bl-update-deps

copilot/fix-1228

build-head-20251001

custom-dialog

parse-uv-v

api-clean-up

parse-uv

release-action

uninstaller-options

full-installer

bundle-git-installer

vcpp-installer

uninstall-cleanup

update-bump-stable-command

frontend-optional-branch-v3-interface-menu

system-pop-up

feat-custom-launch

publish/private

macos-install-path

0.4.40

model_file_import

rh-fix3

robinjhuang-patch-1

rh-manager2

remove-redundant-ci

e2e-bad-start

version-bump-2025-02-20-1740010810152

test/beforeunload-confirm

e2e2-2

debug-log-events

rh-nodes

cb-store

clean-comfy-server

lumina-release

release-2025-feb06

rh-tsx

fix_setting_ids

use_npm

default-no-reload-page

first-time-user-setting

window-style-change

readme-dev-linux

virtual-validation-testing

app-state

enh/Add-Check-For-Updates-button

git-installer

enh/Save-user-preference-for-crashes-after-confirmation-dialog

enh/include-vcredist

error-handling

dev-ken

dev-kendal-todesktop-securit

dev-kendal-startup-test

dev-squirrel-uninstall

dev-kendal

v0.9.4

v0.9.3

v0.9.2

v0.9.1

v0.9.0

v0.8.36

v0.8.35

v0.8.34

v0.8.33

v0.8.32

v0.8.31

v0.8.30

v0.8.29

v0.8.28

v0.8.27

v0.8.26

v0.8.25

v0.8.24

v0.8.23

v0.8.22

v0.8.21

v0.8.20

v0.8.19

v0.8.18

v0.8.16

v0.8.15

v0.8.14

v0.8.13

v0.8.12

v0.8.11

v0.8.10

v0.8.9

v0.8.8

v0.8.7

v0.8.6

v0.8.5

v0.8.4

v0.8.3

v0.8.2

v0.8.1

v0.8.0

v0.7.5

v0.7.4

v0.7.3

v0.7.2

v0.7.1

v0.7.0

v0.6.2

v0.6.1

v0.6.0

v0.5.12

v0.5.11

v0.5.10

v0.5.9

v0.5.8

v0.5.7

v0.5.6

v0.5.5

v0.5.4

v0.5.3

v0.5.2

v0.5.1

v0.5.0

v0.4.76

v0.4.75

v0.4.74

v0.4.73

v0.4.72

v0.4.71

v0.4.70

v0.4.69

v0.4.68

v0.4.67

v0.4.66

v0.4.65

v0.4.64

v0.4.63

v0.4.62

v0.4.61

v0.4.60

v0.4.59

v0.4.58

v0.4.57

v0.4.56

v0.4.55

v0.4.54

v0.4.53

v0.4.52

v0.4.51

v0.4.50

v0.4.49

v0.4.48

v0.4.47

v0.4.46

v0.4.45

v0.4.44

v0.4.41

v0.4.40

v0.4.39

v0.4.36

v0.4.35

v0.4.34

v0.4.33

v0.4.32

v0.4.30

v0.4.29

v0.4.28

v0.4.27

v0.4.26

v0.4.25

v0.4.24

v0.4.23

v0.4.22

v0.4.21

v0.4.20

v0.4.19

v0.4.18

v0.4.17

v0.4.16

v0.4.13

v0.4.12

v0.4.7

v0.4.6

v0.4.5

v0.4.4

v0.4.3

v0.3.18

v0.4.2

Labels

Clear labels   

area: desktop-app

  

Bounty

  

bug

  

bug-cop:answered

  

bug-cop:response-received

  

component: installer

  

component: preload

  

custom node

  

dependencies

  

Design

  

documentation

  

duplicate

  

enhancement

  

expected

  

frontend

  

good first issue

  

installation

  

Low-Priority

  

performance

  

Planned

  

platform: cross-platform

  

platform: windows

  

Potential Bug

  

Potential Bug

  

pull-request

Mirrored from GitHub Pull Request

  

question

  

refactor

  

Release

  

stale

  

User Support

  

V1

No labels

area: desktop-app

Bounty

bug

bug-cop:answered

bug-cop:response-received

component: installer

component: preload

custom node

dependencies

Design

documentation

duplicate

enhancement

expected

frontend

good first issue

installation

Low-Priority

performance

Planned

platform: cross-platform

platform: windows

Potential Bug

Potential Bug

pull-request

question

refactor

Release

stale

User Support

V1

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

Comfy-Org/desktop#466

No description provided.