For Debian and Ubuntu, choose the DEB package; for Fedora systems that use dnf, choose RPM. Choose AppImage if you want to keep the program in your home directory and launch it as a file, after confirming that your architecture and runtime environment are compatible. These steps cover first-time installs and switching between package formats, including download checks, install commands, and common first-launch errors.
Choose a package format for your distro and CPU architecture
Package format and CPU architecture are separate requirements. Ubuntu and Fedora typically use DEB and RPM packages respectively, even on the same CPU architecture. Conversely, two files ending in .deb may target different architectures. Check your distro first, then match the file to the labels on the download page. Renaming a file extension does not convert one package format to another.
cat /etc/os-release
uname -m
Use the first command to identify your distro. Check ID; for derivative distros, ID_LIKE can also help. The second command shows your current kernel architecture. The common output x86_64 corresponds to x86-64 on the download page and is usually called amd64 for DEB packages. aarch64 corresponds to 64-bit ARM and is usually called arm64 for DEB packages. If your userspace architecture differs from the kernel architecture, use the architecture supported by your package manager. On Debian or Ubuntu, check it with dpkg --print-architecture. These name mappings do not mean every package format is available for every architecture.
Install with your package manager
RecommendedUse the DEB or RPM package for your distro. apt or dnf will register the installed package and try to resolve dependencies from enabled software repositories. Installing a local file does not add a repository for future updates.
Best for: distros with a matching package, when you want to manage or uninstall Shadowrocket through the system package manager.
Run the AppImage file
Keep the file in your home directory, make it executable, and launch it directly without registering it with apt or dnf first. The file must still meet your architecture and runtime requirements.
Best for: manually managing the program file, or systems without a suitable DEB or RPM package that can run the AppImage.
Find the downloaded file and check its name
Open the download page
Go to the Linux section of the download page and select a file that matches the package format and architecture you checked above. Choose just one installation method; downloading all three formats will not provide any missing dependencies.
Locate the downloaded file
Find the file in your browser's download history, open its containing folder, and make sure the download has finished. Don't use a temporary download file as the installer, and don't assume the file is in a folder named
Downloads.Open the file's directory
In a terminal, use
cdto enter the directory containing the file. Put the path in double quotes if it contains spaces. Runpwdto check the current directory, thenls -lto verify the filename. Run the commands below from this directory.Check the command arguments
Shadowrocket.deb,Shadowrocket.rpm, andShadowrocket.AppImageare example filenames. Use the actual filename when running a command, keep the leading./, and remember that Linux filenames are case-sensitive. If the filename contains spaces, enclose the entire./filenamein double quotes.
Install DEB with apt or RPM with dnf
Run only the command that matches the package format you downloaded. The ./ prefix tells the package manager to use a local file in the current directory rather than search for a package by name in a repository. The command will show which packages it plans to install, upgrade, or remove. Review the list before continuing, especially if any removals are unexpected.
Install a DEB package
- Supported systems
- Debian, Ubuntu, and other distros that use apt
- Install command
sudo apt install "./Shadowrocket.deb"- Check architecture
dpkg --print-architecture- Read the package name
dpkg-deb -f "./Shadowrocket.deb" Package
If you see a missing dependency error, check the package name and version mentioned in the message, then review your current distro's software repositories.
Install an RPM package
- Supported systems
- Fedora and other distros that use dnf
- Install command
sudo dnf install "./Shadowrocket.rpm"- Read the package architecture
rpm -qp --qf '%{ARCH}\n' "./Shadowrocket.rpm"- Read the package name
rpm -qp --qf '%{NAME}\n' "./Shadowrocket.rpm"
RPM is a package format. That doesn't mean every RPM-based distro uses dnf or that packages are interchangeable across distros.
After the command finishes, use the query command in the card to find the package's internal name. For DEB packages, run dpkg -s followed by that name to check the status. Status: install ok installed means the package is registered as installed. For RPM packages, query the name with rpm -q. Don't use the downloaded filename as the internal package name. Once installation is confirmed, search for Shadowrocket in your desktop's application menu.
Make the AppImage executable and launch it
If you plan to use the AppImage regularly, move it to a convenient location in your home directory first, then run the commands below from that directory. The first command grants execute permission to the file's owner only; the second launches it as the current user. Neither command requires sudo.
chmod u+x "./Shadowrocket.AppImage"
"./Shadowrocket.AppImage"
- Keep the terminal open: If double-clicking the file does nothing, launch it from a terminal to see the error output. Start with the first specific error, then check whether the issue is permissions, architecture, or the runtime environment.
- File and menu entry are different: Running an AppImage directly does not add it to the desktop application menu. If it doesn't appear in a menu search, go back to its directory and run the same launch command.
- Program and settings are separate: Before replacing an AppImage, quit the running program, download the new file, make it executable, and launch it to confirm it works. Deleting the old AppImage removes only the program file; it does not clear application settings stored in your home directory.
Common installation and startup errors
The file downloaded, but why can't I find it?
Run pwd and ls -l to confirm the terminal is in the download location shown by your browser. Repeated downloads may add a number to the filename, and capitalization must match the name on disk. In the terminal, type ./ and the first few characters of the filename, then press Tab to complete it and avoid typing errors.
What if apt or dnf can't install a dependency?
Note the missing dependency, required version, and your distro. If apt reports outdated package indexes or cannot locate a dependency, run sudo apt update. With dnf, check enabled repositories using dnf repolist. If the required version is still unavailable after refreshing the indexes, return to the download page and check that the package matches your system. Don't force the installation past missing dependencies.
Why do I still get Permission denied after making the file executable?
Use ls -l to confirm the owner's permissions include x, then run findmnt -T . -o TARGET,OPTIONS to check the mount point for the current directory. If the options include noexec, adding execute permission won't let you run the file there. Move it to a suitable directory in your home folder, check its permissions again, and launch it.
What if the AppImage reports missing FUSE or libfuse.so.2?
Check whether the error specifically mentions libfuse.so.2. If it does, use your distro's repositories to find a compatible package that provides the library. Having FUSE 3 installed does not mean the system also has the FUSE 2 library. If the environment does not allow the mount operation required by AppImage, and the download page offers a compatible DEB or RPM package, install that package with the corresponding package manager instead.
Download Shadowrocket
Get Shadowrocket for iPhone and iPad from the App Store for a one-time $2.99 purchase. Check the App Store listing for system requirements. The Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free; download their installers from this site's download page.