Signin Signup

Linux issue: appimages dont run without requirement fuse2/libfuse2 in some linux (my case)

fuse2 is deprecated in favor of fuse3 in some linux. Siyuan appimages require libfuse2/libfuse2r64 to run, on some linux it will not run without it. Installing the dependency manually fixes the issue. Sources: appimage.org - fuse

NOTE: libfuse2 package was renamed to libfuse2t64 in newer version.

Method 2 worked for me (because my apt repo didnt have the library by default), method 2 (extracting) works, but cumbersome. ⚠️ Warning: test in a Virtual Machine first, wrong action could break OS, but fixable). Disclaimer: not liable for OS breakage for installing e.g. wrong package or wrong architecture (check architecture: uname -r or uname -a).

Method 1: just install from package manager (if available for your os)

Just install it from your linux package manager (if the libraries libfuse2 or libfuse2t64 are available for your os), as recommended by appimage.org - fuse. Instructions at source link

Method 2: manually install libfuse2t64

Install libfuse2 manually from the Debian package pool. Download and install package from Debian release that still provides it, then run .AppImage as usual. Perform all of following (for Debian in this case):

  1. Download package that matches architecture of guest (uname -a). Browse Debian pool directory at deb.debian.org/debian/pool/main/f/fuse/.
# For arm64 
wget http://ftp.debian.org/debian/pool/main/f/fuse/libfuse2t64_2.9.9-9_arm64.deb
  1. Install downloaded package and resolve any outstanding dependencies. Adjust file name to match package you downloaded.
sudo dpkg -i libfuse2t64_2.9.9-9_arm64.deb
sudo apt --fix-broken install
  1. Verify that library is installed:
dpkg -l libfuse2

Method 3: run appimage using

The appimage--extract command allows you to extract files from an AppImage.

  1. First, determine if AppImage file uses newer type 2 format
/path/to/your.AppImage --appimage-help
  1. Extract appimage content by running:
./path/to/appimage.AppImage --appimage-extract
  1. The extracted contents will be stored in directory called squashfs-root in current working directory.
cd squashfs-root/
./siyuan
    2 Operate
    Siysuy updated this article at 2026-10-17 16:41:34
    Siysuy updated this article at 2026-10-17 16:40:14
    2 Operate
    3 Reply
    2
    448 10 4 15 419

    Related articles

    3 Reply
    Linux issue: appimages dont run without requirement fuse2/libfuse2 in some linux (my case)

    Welcome to here!

    Here we can learn from each other how to use SiYuan, give feedback and suggestions, and build SiYuan together.

    Signup About
    Please input reply content ...
    • Siysuy •
      Author
      • Siyuan AppImage filename: siyuan-3.8.7 and siyuan 3.8.6
      • Linux distro, version CPU arch: it was for a client I provided support to, I currently dont have access to his computers, but he was using a few computers with Debian and derivative distros (perhaps: vanilla Debian, MX linux and Linux Mint etc). Hence, I just tested it again on a fresh 7.1.5+kali-amd64 VM-guest with Intel architecture x86_64 and same issue. Core issue: remains that fuse2 deprecation in favor of fuse3.
      • terminal error report: Method 1 fixed it for my client (as mentioned in my original post), so i dont have the terminal error, but it was close to:
      dlopen(): error loading libfuse.so.2 AppImages require FUSE to run.

      Here is a source bug report with similar fuse 2 error on debians: Issue #2963 · VSCodium/vscodium

      1 Reply
      1 Operate
      Siysuy updated this reply at 2026-10-18 13:33:16
    • MiscReply
    • 88250 • • 1
      MOD

      Thanks for the additional details. We’ve updated the Linux AppImage packaging to use a statically linked runtime, removing the dependency on the system’s libfuse2 library. Normal FUSE support is still required.

      The change is on dev: #20667. Isolated runtime tests passed; testing with the full application on affected systems is still needed.

      Please try the next build containing this change and let us know whether it resolves the startup issue.

    • 88250 •
      MOD

      Thanks for sharing. Could you provide:

      • Your Linux distribution, version, and CPU architecture
      • The exact SiYuan AppImage filename
      • The full error output when launching it from a terminal

      Also, did installing libfuse2t64 allow the AppImage to launch normally, or do you still need to extract it first? This will help us confirm the cause.

      1 Reply
    Siysuy
    Reply
    18
     Article
    15
     Point
    10