mirror of
https://github.com/open-webui/open-webui.git
synced 2026-07-16 23:21:44 -05:00
[GH-ISSUE #24060] issue: [macOS] Open WebUI Desktop crashes on launch due to Electron Framework code signature mismatch (DYLD Library missing) #107165
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @sasakocic on GitHub (Apr 24, 2026).
Original GitHub issue: https://github.com/open-webui/open-webui/issues/24060
Check Existing Issues
Installation Method
Other
Open WebUI Version
0.0.9
Ollama Version (if applicable)
No response
Operating System
MacOS 26.4
Browser (if applicable)
No response
Confirmation
README.md.Expected Behavior
App should work on macOS 26.4
Actual Behavior
Open WebUI Desktop fails to launch on macOS with an immediate
EXC_CRASH (SIGABRT)termination. The crash occurs during dynamic library loading (dyld) due to a code signature mismatch between the main executable and the bundledElectron Framework.framework. macOS enforces strict code signature consistency across all nested frameworks, but the current build has mismatched or improperly deep-signed binaries. Runningxattr -d com.apple.quarantinedoes not resolve the issue, as this is a code signing validation failure, not a quarantine block.Steps to Reproduce
Check Console/Crash Reporter for Termination Reason: Namespace DYLD, Code 1, Library missing
Logs & Screenshots
Additional Information
Environment:
0.0.9Issue:
Open WebUI Desktop fails to launch on macOS with an immediate
EXC_CRASH (SIGABRT)termination. The crash occurs during dynamic library loading (dyld) due to a code signature mismatch between the main executable and the bundledElectron Framework.framework. macOS enforces strict code signature consistency across all nested frameworks, but the current build has mismatched or improperly deep-signed binaries. Runningxattr -d com.apple.quarantinedoes not resolve the issue, as this is a code signing validation failure, not a quarantine block.Steps to Reproduce:
v0.0.9on macOSTermination Reason: Namespace DYLD, Code 1, Library missingCrash Log Excerpt:
Workaround / Temporary Fix:
Users can bypass this by re-signing the entire app bundle deeply with an ad-hoc signature:
After running these commands, the app launches normally.
Suggested Fix for Developers:
--deepsigning during code signing/notarization.Electron Framework.framework,Chromium Framework.framework, etc.) are signed with the same identity/Team ID as the main executable.codesign --verify --deep --strict "/path/to/app") to catch signature mismatches before release.@sasakocic commented on GitHub (Apr 24, 2026):
Workaround / Temporary Fix:
Users can bypass this by re-signing the entire app bundle deeply with an ad-hoc signature:
After running these commands, the app launches normally.
Suggested Fix for Developers:
--deepsigning during code signing/notarization.Electron Framework.framework,Chromium Framework.framework, etc.) are signed with the same identity/Team ID as the main executable.codesign --verify --deep --strict "/path/to/app") to catch signature mismatches before release.@tjbck commented on GitHub (Apr 24, 2026):
Should be opened from desktop repo.