lmstudio-ai / lmstudio-ai/docs

AppImage fails to start / missing libfuse.so.2

Open Beginner friendly
#247 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
MDX
Stars
172
Forks
128
Avg merge
8m
Merged PRs (30d)
1

Description

How to reproduce / behaviour on my system:

- System is: Linux kub 7.0.0-27-generic #27-Ubuntu (Kubuntu)
- Download the AppImage from: https://lmstudio.ai/download/latest/linux/x64
- Double click AppImage, nothing happens
- Starting from console: `./LM-Studio-0.4.21-2-x64.AppImage` reveals `dlopen(): error loading libfuse.so.2`
- Installing the missing lib solves the problem

Improvement suggestions:

- Mention the lib(s) in system requirements
- Check dependencies that are not bundled in AppImage on startup and provide a GUI message

Contributor guide

Open the contributing guide

Research direction

Start by locating the Linux download or system-requirements documentation for the AppImage. Document the libfuse.so.2 dependency and the installation guidance described in the report, then verify that the launch instructions clearly explain how to resolve the reported error.

Written by the indexing model from the issue text.

Assessment

Tech stack
linux
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.