You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: add FUSE troubleshooting for AppImage on modern Linux
modern distros (Ubuntu 22.04+, Debian 12+) ship FUSE 3 but AppImages
require FUSE 2. document the fix (install libfuse2/libfuse2t64) and
the --appimage-extract-and-run alternative.
Copy file name to clipboardExpand all lines: README.md
+31Lines changed: 31 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -46,6 +46,7 @@ When in doubt, pick one of package formats with built-in automatic update mechan
46
46
-[Why am I missing the system tray menu on Linux?](#why-am-i-missing-the-system-tray-menu-on-linux)
47
47
-[Why can't I install IPFS Desktop under Debian 11?](#why-cant-i-install-ipfs-desktop-under-debian-11)
48
48
-[Why can't I start IPFS Desktop under Debian 10?](#why-cant-i-start-ipfs-desktop-under-debian-10)
49
+
-[Why does the AppImage fail with a FUSE error?](#why-does-the-appimage-fail-with-a-fuse-error)
49
50
-[`GTK 2/3 symbols detected. Using GTK 2/3 and GTK 4 in the same process is not supported`](#gtk-23-symbols-detected-using-gtk-23-and-gtk-4-in-the-same-process-is-not-supported)
50
51
-[Where are my configuration and log files?](#where-are-my-configuration-and-log-files)
@@ -234,6 +235,36 @@ This is a known issue with Electron/Chrome and some hardened kernels. More detai
234
235
$ ipfs-desktop --no-sandbox
235
236
```
236
237
238
+
### Why does the AppImage fail with a FUSE error?
239
+
240
+
If you see this error when running the AppImage:
241
+
242
+
```
243
+
dlopen(): error loading libfuse.so.2
244
+
AppImages require FUSE to run.
245
+
```
246
+
247
+
This happens because modern Linux distributions ship with FUSE 3, but AppImages currently require FUSE 2 (libfuse2). The two versions can coexist safely.
> **Note:** This is a known limitation of the AppImage runtime used by electron-builder. Future releases may include a static runtime that removes this dependency. See [AppImage/AppImageKit#1120](https://github.com/AppImage/AppImageKit/issues/1120) for upstream progress.
265
+
266
+
See [AppImage FUSE documentation](https://docs.appimage.org/user-guide/troubleshooting/fuse.html) for more details.
267
+
237
268
### `GTK 2/3 symbols detected. Using GTK 2/3 and GTK 4 in the same process is not supported`
238
269
239
270
See [ipfs-desktop#2952](https://github.com/ipfs/ipfs-desktop/issues/2952).
0 commit comments