Linux

Linux version installation guide

1. Download the installation package

Open official download page, select Linux. The official website provides installation packages in different formats depending on the system and architecture:

Usage scenario	Recommended choice
Ubuntu, Debian, Linux Mint	Choose the one that matches your architecture .deb package.
Fedora, RHEL, openSUSE	Choose the one that matches your architecture .rpm package.
Other distributions or portable use	Choose the one that matches your architecture .AppImage package.

Intel / AMD devices usually choose the x64 (or x86_64) version; ARM devices choose the ARM64 (or aarch64) version. If you're unsure of the architecture, run in the terminal uname -m:x86_64 corresponds to x64,aarch64 or arm64 corresponds to ARM64.

2. Install and launch

• .deb and .rpm: Prefer using your distribution's software installer or package manager to open the installation package, then launch Cherry Studio from the applications menu.
• .AppImage: After granting the file executable permission, double-click it to run; you can also run in the terminal chmod +x filename.AppImage to launch it.

Cannot start

First confirm that the installation package matches your system architecture. If AppImage cannot be started and shows FUSE or libfuse related errors, please install the corresponding compatibility component according to your current distribution's official documentation.

If it still cannot start, please include the distribution, desktop environment, device architecture, installation package name, and the complete error message in your feedback.

Next step

After you see the Cherry Studio main interface, continue to complete the quick start.