Sunshine: A Self-Hosted Game Stream Host with Deep Platform Trade-offs
GitHub describes it as Self-hosted game stream host for Moonlight.. The repository metadata lists C++ as its primary language. The metadata lists the GPL-3.0 license. This article stays within the project description and details documented in the GitHub repository README.
At a glance
- What is it?
- Sunshine turns a PC into a Moonlight streaming server, but its feature matrix reveals sharp platform differences. This review covers what works, what doesn't, and who should skip it.
- Who is it for?
- Adopt Sunshine if you run Linux or Windows, need hardware encoding across AMD, Intel, or Nvidia GPUs, and want a self-hosted alternative to proprietary streaming. Avoid it if you need macOS gamepad emulation without installing the separately licensed Virtual HID Broker or need Windows service-mode screen capture (broken).
- Can I use it commercially?
- Yes, with conditions. GPL-3.0 is a copyleft licence: if you distribute software that includes it, you must release that software's source code under the same licence. Running it internally without distributing it does not trigger that obligation.
- Is it still maintained?
- Yes. The repository received new commits within the last day.
- What is it written in?
- Mainly C++, according to GitHub's language statistics.
Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.
Star history
- LizardByte/Sunshine43,453 ★ · +3,309
| Repository | 2026-08-13 | 2026-11-15 |
|---|---|---|
| LizardByte/Sunshine | 40.1k | 43.5k |
3,309 Stars in the last 94 days, measured from the daily GitHub snapshot. Compare with other projects
Editorial analysis
What Sunshine Actually Solves
Sunshine is a host-side daemon that pairs with Moonlight clients. It solves the problem of streaming games from a machine you own to other screens, without a commercial cloud service. The target user is someone who already has a gaming PC or a server with a capable GPU and wants low-latency access from a phone, laptop, or TV. The README describes it as offering low-latency, cloud gaming server capabilities, but the emphasis is on local control. You configure it through a web UI, pair clients from a browser, and the host does the encoding. This is not a game store or a launcher. It is a transport layer for video and input.
The Encoding API Matrix Is the Core Mechanism
Sunshine's real work is encoding video. The README lists seven encoding APIs: AMF, Media Foundation, NVENC, QuickSync, VAAPI, Video Toolbox, and Vulkan Video. Each maps to specific GPU vendors and operating systems. On Windows, you get AMF for AMD, NVENC for Nvidia, QuickSync for Intel, and Media Foundation for Qualcomm. On Linux, NVENC and VAAPI cover AMD, Intel, and Nvidia, but QuickSync is absent. macOS only supports Video Toolbox. The key point is that no single API works everywhere. Software encoding is the universal fallback, but it trades latency for compatibility. This matrix is the first thing to check when choosing a host machine. If you have an Intel GPU on Linux, VAAPI works, but Vulkan Video is marked yellow, meaning partial support. That distinction matters for real-time streaming.
Screen Capture: Where Platform Gaps Show
Capture methods are as fragmented as encoding. Windows uses DXGI Desktop Duplication, which is fully supported. Linux and FreeBSD have KMS/DRM, X11, Wayland (wlroots), XDG Desktop Portal, and KWin Screencast. macOS uses ScreenCaptureKit. The notable gap is Windows.Graphics.Capture: it works in portable mode but fails in service mode. That means running Sunshine as a Windows service breaks this capture path. For a self-hosted streamer, this is a real limitation. If you plan to run Sunshine as a background service on Windows, you will need to use DXGI instead, which may not work in all remote desktop sessions. The README's yellow marker for Windows.Graphics.Capture is a warning to test before relying on it.
Gamepad Emulation: macOS Users Lose Out
The gamepad emulation table is stark. Linux and Windows support all listed controllers: Generic, DualShock, DualSense, Switch Pro, Xbox 360, Xbox One, and Xbox Series. FreeBSD has partial support, marked yellow, with missing motion, touchpad, battery state, RGB LEDs, adaptive triggers, and raw HID output. macOS lists every controller as supported, but only with the separately installed and licensed Virtual HID Broker, which Windows also needs for all profiles. The README notes that clients may support other gamepads, but the host-side emulation is what creates the virtual device.
Getting It Running: Installation and Configuration
The README points to a web UI for configuration and pairing. The README links to Docker images, a Flathub package, and a Windows winget manifest. From the README, the practical paths are: download a release from GitHub, install via Docker using the lizardbyte/sunshine image, or use the Flatpak for Linux. The web UI is the main control surface. You pair Moonlight clients from the web interface. The README says you can pair from the local server or any mobile device. The full documentation is hosted on Read the Docs. The key takeaway: installation is distribution-specific, and you should consult the stable docs for your OS.
A Genuine Limitation: The Service Mode Capture Failure
The clearest failure mode is the Windows service mode issue. Windows.Graphics.Capture is marked as not working when Sunshine runs as a service. This is a concrete, documented limitation. If you want Sunshine to run in the background without a logged-in user, you will hit this wall. The portable mode works, but that means Sunshine runs as a user process, which may require an active session. For a headless streaming box, that is an operational constraint. Another limitation is that gamepad emulation on macOS needs the separately installed and licensed Virtual HID Broker, which we already covered. The documentation also shows that Vulkan Video is only partially supported on Linux for Intel and Nvidia, which could cause encoder selection issues. You should not assume every advertised API works out of the box.
Alternative: Moonlight Embedded vs. Sunshine
The obvious alternative is Moonlight itself, but that is a client. On the host side, the comparison is with proprietary tools like Nvidia GameStream (now deprecated) or Steam Remote Play. The real difference in approach is that Sunshine is open source and self-hosted, while GameStream was tied to Nvidia hardware and cloud services. Steam Remote Play is a separate ecosystem with its own client and server, and it does not require a Moonlight client. Sunshine's approach is to be a pure host, relying on the Moonlight protocol. That means you get a modular setup: choose your client, choose your host. The trade-off is that you must manage pairing and configuration yourself, whereas Steam Remote Play handles most of it automatically. If you already use Moonlight clients, Sunshine is the natural host. If you want zero-configuration, Steam Remote Play is simpler but less flexible.
Maintenance and License Implications
Sunshine is under GPL-3.0, which means any derivative work you distribute must also be GPL-3.0. That is a serious consideration if you plan to embed Sunshine in a commercial product. The project has an active release cadence, with releases on 2026-09-15, 2026-11-02, and 2026-11-03, suggesting regular maintenance. The repository is not archived, and the last push was 2026-11-02. The README links to CI, localization, and code coverage, indicating a mature development process. However, the documentation is hosted externally, so you need to check for breaking changes between releases. The versioning scheme (for example v2026.1103.23515) is date-based, which makes it easy to track updates. The cost of maintenance is mostly in keeping up with encoder API changes and platform updates. For a self-hoster, that means occasional config changes. For a vendor, the GPL license is the bigger hurdle.
Editorial conclusion
Adopt Sunshine if you run Linux or Windows, need hardware encoding across AMD, Intel, or Nvidia GPUs, and want a self-hosted alternative to proprietary streaming. Avoid it if you need macOS gamepad emulation without installing the separately licensed Virtual HID Broker or need Windows service-mode screen capture (broken). Before adopting, verify your exact GPU and OS combination against the encoding and capture tables, and test the web UI pairing flow on your network. Also confirm the GPL-3.0 license fits your distribution plans, especially if you modify the source.
Frequently asked questions
how to use sunshine and moonlight
Sunshine is the host and Moonlight is the client. You connect to Sunshine from any Moonlight client on a variety of devices, and a web UI handles configuration and client pairing, so pairing can be done from the local server or from any mobile device.
how to install sunshine
The README links Docker Hub and the GitHub container package under lizardbyte/sunshine, a Flathub app at dev.lizardbyte.app.Sunshine, a winget manifest, and the full documentation on Read the Docs with separate stable and beta channels.
how to use sunshine and moonlight on different networks
Pairing does not have to happen at the host, because the web UI allows client pairing from your favorite web browser and you can pair from the local server or from any mobile device.
how to use sunshine over the internet
The same pairing answer covers it: you connect from any Moonlight client on a variety of devices, and pairing happens in the web UI from a browser. The full documentation is on Read the Docs.
how to install sunshine on pc
On PC the compatibility tables cover Windows and Linux. Hardware encoding on Windows is AMF for AMD, NVENC for NVIDIA, QuickSync for Intel and Media Foundation for Qualcomm, with software encoding marked as available on every platform listed.
Official sources
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/lizardbyte-sunshine)Star history chart for your README
[](https://hysenlabs.com/projects/lizardbyte-sunshine)Was this useful?