Skip to content

[BUG] Termix Sharp module bug report 2.7.0 · MD #1214

Description

@khaledfa2

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.

Metadata

Metadata

Assignees

No one assigned

    Type

    Projects

    Status
    Ready for Release

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions