Termix-SSH / Termix-SSH/Support

[BUG] Termix Sharp module bug report 2.7.0 · MD

Open
#1,214 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug platform-desktop platform-macos ui
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
  1. 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).
  2. Launch the app.
  3. 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

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.