Linux Installation

Install Sunshine on Linux using AppImage, Flatpak, or distribution packages

Sunshine supports multiple installation methods on Linux. Choose the method that best fits your distribution and requirements.

CUDA Compatibility

CUDA is used for NVFBC capture on NVIDIA GPUs.

See CUDA GPUS to cross-reference Compute Capability to your GPU. The table below applies to packages provided by LizardByte. If you use an official LizardByte package, then you do not need to install CUDA separately.

Package	CUDA Version	Min Driver	Compute Capabilities
sunshine.AppImage	12.9.1	575.57.08	50, 52, 60, 61, 62, 70, 72, 75, 80, 86, 87, 89, 90, 100, 101, 103, 120, 121
sunshine-ubuntu-22.04-.deb	12.9.1	575.57.08	50, 52, 60, 61, 62, 70, 72, 75, 80, 86, 87, 89, 90, 100, 101, 103, 120, 121
sunshine-ubuntu-24.04-.deb	12.9.1	575.57.08	50, 52, 60, 61, 62, 70, 72, 75, 80, 86, 87, 89, 90, 100, 101, 103, 120, 121
sunshine-debian-trixie-.deb	12.9.1	575.57.08	50, 52, 60, 61, 62, 70, 72, 75, 80, 86, 87, 89, 90, 100, 101, 103, 120, 121
sunshine_.flatpak	12.9.1	575.57.08	50, 52, 60, 61, 62, 70, 72, 75, 80, 86, 87, 89, 90, 100, 101, 103, 120, 121
sunshine.pkg.tar.zst	12.9.1	575.57.08	50, 52, 60, 61, 62, 70, 72, 75, 80, 86, 87, 89, 90, 100, 101, 103, 120, 121
Sunshine (copr - Fedora)	12.9.1	575.57.08	50, 52, 60, 61, 62, 70, 72, 75, 80, 86, 87, 89, 90, 100, 101, 103, 120, 121
Sunshine (copr - OpenSUSE)	12.9.1	575.57.08	50, 52, 60, 61, 62, 70, 72, 75, 80, 86, 87, 89, 90, 100, 101, 103, 120, 121

Installation Methods

Debian/Ubuntu

Install

Download sunshine-{distro}-{distro-version}-{arch}.deb and install:

sudo dpkg -i ./sunshine-{distro}-{distro-version}-{arch}.deb

The {distro-version} is the version of the distro we built the package on. The {arch} is the architecture of your operating system.

You can double-click the deb file to see details about the package and begin installation.

Uninstall

sudo apt remove sunshine

Arch Linux

Install Prebuilt Packages

Use AUR packages at your own risk.

Follow the instructions at LizardByte’s pacman-repo to add the repository. Then run:

pacman -S sunshine

Install PKGBUILD Archive

1. Download and extract

   wget https://github.com/LizardByte/Sunshine/releases/latest/download/sunshine.pkg.tar.gz
   tar -xvf sunshine.pkg.tar.gz
   cd sunshine
   
2. Install optional dependencies

   # Nvidia GPU encoding support
   pacman -S cuda
   
   # AMD GPU encoding support
   pacman -S libva-mesa-driver
   
3. Build and install

   makepkg -si
   

Uninstall

pacman -R sunshine

Fedora/OpenSUSE

The package name is case-sensitive.

Install from GitHub Releases

Download Sunshine-{version}.{distro+version}.{arch}.rpm and install:

sudo dnf install ./Sunshine-{version}.{distro}.{arch}.rpm

The {distro+version} is the distro and distro version of the distro we built the package on. The {arch} is the architecture of your operating system.

You can double-click the rpm file to see details about the package and begin installation.

Install from Copr

Stable builds are only available if the Sunshine release was made after the Fedora version release. Because of this, it is often recommended to use the beta copr; however, you do not need to regularly update. This could lead to annoyances in rare cases where there may be a breaking change.

1. Enable copr repository

   For stable releases:

   sudo dnf copr enable lizardbyte/stable
   

   For beta releases:

   sudo dnf copr enable lizardbyte/beta
   
2. Install the package

   sudo dnf install Sunshine
   

Uninstall

sudo dnf remove Sunshine

AppImage

Use distro-specific packages instead of the AppImage if they are available. AppImage does not support KMS capture.

The AppImage is built on Ubuntu 22.04, which requires glibc 2.35 or newer and libstdc++ 3.4.11 or newer.

Install

1. Download AppImage

   cd ~
   wget https://github.com/LizardByte/Sunshine/releases/latest/download/sunshine.AppImage
   
2. Install Sunshine

   ./sunshine.AppImage --install
   

Run

./sunshine.AppImage --install && ./sunshine.AppImage

Uninstall

./sunshine.AppImage --remove

Flatpak

Use distro-specific packages instead of the Flatpak if they are available. Flatpak does not support KMS capture.

This package requires that you have Flatpak installed.

Install from Flathub

System level

flatpak install --system flathub dev.lizardbyte.app.Sunshine

flatpak install --user flathub dev.lizardbyte.app.Sunshine

Install from Local File

Replace {arch} with your system architecture.

System level

flatpak install --system ./sunshine_{arch}.flatpak

flatpak install --user ./sunshine_{arch}.flatpak

Additional Installation (Required)

flatpak run --command=additional-install.sh dev.lizardbyte.app.Sunshine

Run

Run with NVFBC capture (X11 Only) or XDG Portal (Wayland Only):

flatpak run dev.lizardbyte.app.Sunshine

Uninstall

flatpak run --command=remove-additional-install.sh dev.lizardbyte.app.Sunshine
flatpak uninstall --delete-data dev.lizardbyte.app.Sunshine

Homebrew

The Homebrew package is experimental on Linux.

This package requires that you have Homebrew installed.

Install

brew update
brew upgrade
brew tap LizardByte/homebrew
brew install sunshine

Uninstall

brew uninstall sunshine

For beta you can replace sunshine with sunshine-beta in the above commands.

Post-Installation Setup

Services

Two service unit files are available. Pick “sunshine” for unprivileged XDG Portal or X11 capture, otherwise pick “sunshine-kms” for privileged KMS capture.

Start once:

systemctl --user start sunshine

Start on boot (unprivileged; swap logic for KMS):

systemctl --user --now disable sunshine-kms
systemctl --user --now enable sunshine

Input Devices

If inputs (mouse, keyboard, gamepads) aren’t working after connecting, add the user running sunshine to the input group.