Install Shadowrocket on Linux: Choose a DEB, RPM, or AppImage

Download Shadowrocket for Linux free from this site. Compare DEB, RPM, and AppImage packages by distro, with apt and dnf install commands and steps to make an AppImage executable.

At a glance

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

Recommended

Use 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

  1. 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.

  2. 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.

  3. Open the file's directory

    In a terminal, use cd to enter the directory containing the file. Put the path in double quotes if it contains spaces. Run pwd to check the current directory, then ls -l to verify the filename. Run the commands below from this directory.

  4. Check the command arguments

    Shadowrocket.deb, Shadowrocket.rpm, and Shadowrocket.AppImage are 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 ./filename in 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"

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.

Download Shadowrocket