Termix-SSH / Termix-SSH/Support
[BUG] Termix Sharp module bug report 2.7.0 · MD
Nobody has claimed this yet.
- Dominant language
- No language data
- Stars
- 28
- Forks
- 4
- PR merge metrics
- No merged PRs in 30d
Description
Title
macOS desktop app stuck on permanent "Loading..." after update to v2.7.0 — missing native "sharp" module (darwin-x64)
Platform
Desktop App - macOS
Server Installation Method
Docker
Version
2.7.0
CLI Installation Method
None
CLI Version
No response
Troubleshooting
- I have examined logs and tried to find the issue
- I have reviewed opened and closed issues
- I have tried restarting the application
- I have checked open issues and ensured this is not a duplicate
The Problem
After the Termix desktop app (Mac App Store, bundle id com.karmaa.termix) auto-updated to v2.7.0, it gets stuck permanently on the "Loading..." screen and never reaches the app UI.
Root cause, confirmed directly in the app's own log (~/Library/Containers/com.karmaa.termix/Data/Library/Application Support/termix/termix-main.log):
Error: Could not load the "sharp" module using the darwin-x64 runtime
"sharp" is a native Node.js image-processing module that ships prebuilt binaries per platform/architecture. On this build, the darwin-x64 binary is missing or broken, so the module fails to load and the app never gets past its startup sequence.
Confirmed this is a real packaging bug, not a corrupted download: performed a full clean reinstall (sudo rm -rf "/Applications/Termix.app", redownloaded fresh from the Mac App Store) and got the identical crash with the identical log error on a completely clean install.
Cross-checked on a second machine: an Apple Silicon Mac (darwin-arm64), same app version, same account, never hit this bug — consistent with the missing binary being specific to the darwin-x64 build.
No data loss risk — the crash happens during app startup, before the local database is ever touched. Saved hosts/connections were confirmed intact after recovery.
How to Reproduce
- On an Intel Mac (darwin-x64), let the Termix Mac App Store app auto-update to v2.7.0 (or install v2.7.0 fresh).
- Launch the app.
- Observe: the app hangs indefinitely on the "Loading..." screen and never reaches the login/host list UI.
Additional Context
Workaround used while this was open: the web UI (self-hosted server, browser access) works normally on the same machine. Apple Silicon Macs are unaffected and can be used normally.
If this is already fixed in a later release (2.8.0 or newer), a confirmation of the fix version would be appreciated so this can be closed out and retested.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Reproduce the launch failure on an Intel Mac and inspect ~/Library/Containers/com.karmaa.termix/Data/Library/Application Support/termix/termix-main.log for the darwin-x64 sharp error. No source file or test is named, so trace the v2.7.0 macOS packaging inputs first. Done means the app launches past Loading... and the sharp module loads on darwin-x64.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- node.js
- Domain
- build-system, desktop
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100