Linux Installation

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

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

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

Download and extract

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

Install optional dependencies

# Nvidia GPU encoding support
pacman -S cuda

# AMD GPU encoding support
pacman -S libva-mesa-driver

Build and install

makepkg -si

Uninstall

pacman -R sunshine

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.

Enable copr repository

For stable releases:

sudo dnf copr enable lizardbyte/stable

For beta releases:

sudo dnf copr enable lizardbyte/beta

Install the package

sudo dnf install Sunshine

Uninstall

sudo dnf remove Sunshine

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

Download AppImage

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

Install Sunshine

./sunshine.AppImage --install

Run

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

Uninstall

./sunshine.AppImage --remove

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

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

Install from Local File

Replace {arch} with your system architecture.

flatpak install --system ./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

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.

Get Started

Installation

Configuration

Guides

Deployment

Linux Installation

CUDA Compatibility

Installation Methods

Install

Uninstall

Install Prebuilt Packages

Install PKGBUILD Archive

Uninstall

Install from GitHub Releases

Install from Copr

Uninstall

Install

Run

Uninstall

Install from Flathub

Install from Local File

Additional Installation (Required)

Run

Uninstall

Install

Uninstall

Post-Installation Setup

Services

Input Devices

Build docs developers (and LLMs) love

Get Started

Installation

Configuration

Guides

Deployment

​CUDA Compatibility

​Installation Methods

​Install

​Uninstall

​Install Prebuilt Packages

​Install PKGBUILD Archive

​Uninstall

​Install from GitHub Releases

​Install from Copr

​Uninstall

​Install

​Run

​Uninstall

​Install from Flathub

​Install from Local File

​Additional Installation (Required)

​Run

​Uninstall

​Install

​Uninstall

​Post-Installation Setup

​Services

​Input Devices

Build docs developers (and LLMs) love

CUDA Compatibility

Installation Methods

Install

Uninstall

Install Prebuilt Packages

Install PKGBUILD Archive

Uninstall

Install from GitHub Releases

Install from Copr

Uninstall

Install

Run

Uninstall

Install from Flathub

Install from Local File

Additional Installation (Required)

Run

Uninstall

Install

Uninstall

Post-Installation Setup

Services

Input Devices