All posts
Tools

Is Moonlight + Sunshine Worth the Hassle? An Honest Setup Guide for Remote PC Gaming

A Andrew July 20, 2026 11 min read

Axiom gaming mode features: smooth 60fps video, controls that keep up

What makes a remote gaming experience actually good? Is it just the video quality, or the sheer effort you put into getting it to work in the first place? Imagine your powerful gaming rig, that beast of silicon and steel, finally tamed and streamed to a thin client in your living room, or even your phone on a lunch break. This isn’t just a dream; it’s the promise of Moonlight and Sunshine. But unlike buying a sleek, ready-to-drive sports car, this setup is more like building your own custom racing machine from a kit. You get unparalleled performance, but you’ll need to know your way around a toolbox – and be prepared for a few scraped knuckles along the way. This guide will walk you through assembling that machine, including all the greasy, annoying parts nobody likes to talk about.

Alt text: A tablet displays a high-quality game stream via Moonlight, with a desktop gaming PC in the background, illustrating remote play.

Building Your Own Remote Gaming Machine: What Moonlight + Sunshine Really Asks Of You

At its heart, Moonlight and Sunshine create a dedicated, low-latency pipeline between your powerful gaming PC and a lightweight client. This isn’t just screen sharing; it’s a finely tuned machine built for gaming.

  • Sunshine: This is the open-source, self-hosted game stream host software. It gained prominence as a replacement for NVIDIA’s proprietary GameStream, which NVIDIA discontinued. Sunshine runs directly on your Windows gaming PC. Its primary role is to encode your game video using your graphics card’s dedicated hardware encoder – whether that’s NVIDIA NVENC, AMD AMF, or Intel Quick Sync. It also handles streaming audio, video, and receiving your inputs from the client device. This demonstrates how your existing gaming hardware is leveraged for maximum efficiency.
  • Moonlight: On the other side of the connection is Moonlight, the open-source client software. It’s available on a vast array of devices, including Windows, macOS, Linux, Android, iOS, Apple TV, Raspberry Pi, ChromeOS, and even within web browsers. Moonlight’s job is to decode the stream sent by Sunshine and transmit your inputs back to the host PC. This shows how widely accessible your gaming rig can become, from virtually any modern device you own.

Why Bother with Moonlight + Sunshine?

The effort required for a Moonlight + Sunshine setup yields significant rewards for dedicated remote gamers.

  • Unrivaled Performance (When Tuned): When properly configured, Moonlight + Sunshine leverages hardware encoding for minimal latency. It can handle high resolutions, including 4K.
  • Broad Client Compatibility: You’re not tied to proprietary hardware. Play on phones, tablets, smart TVs, other PCs – your options are extensive, not just dedicated streaming boxes. This means you can use the devices you already own, not buy new ones.
  • Open Source & Community Driven: Both projects are open source, meaning transparent code, active development, and a helpful community for troubleshooting. This fosters trust and continuous improvement in the software.
  • Cost-Effective: The software is free, and it utilizes your existing gaming hardware. This highlights how accessible high-performance streaming can be without subscription fees or additional hardware purchases.
  • Customization & Control: You have granular control over your streaming experience. Fine-tune resolution, bitrate, framerate, and more to your exact preferences. Not only can you adjust the stream, but you also retain full control over specific game settings on the host PC. This puts you in the driver’s seat for performance.

How Do You Set Up Moonlight + Sunshine for Optimal Gaming? (A Step-by-Step Build)

This section details the process of assembling your remote gaming machine, from preparing the host to configuring the network.

  1. Host PC Preparation (The Engine Block):

    • Update GPU Drivers: This is crucial. Ensure your NVIDIA, AMD, or Intel graphics drivers are up to date. Newer drivers often bring performance improvements and bug fixes for hardware encoding.
    • Install Sunshine:
      • Navigate to the Sunshine GitHub releases page.
      • Download the latest stable Windows installer (e.g., sunshine-windows-installer.exe).
      • Run the installer. It’s a standard Windows installation process.
      • During the initial run, Windows Firewall will likely prompt you to allow Sunshine access. Grant it access for both private and public networks. This shows the first hurdle: ensuring network communication isn’t blocked by your local firewall.
    • Configure Sunshine (The Carburetor):
      • After installation, Sunshine typically opens a web UI in your browser, usually at http://localhost:47990. Bookmark this.
      • You’ll be prompted to set up a username and a PIN. This PIN is essential for pairing with Moonlight clients.
      • Review the General settings. The default port numbers (47984, 47989, 48010 for TCP; 47998, 47999, 48000, 48002, 48010 for UDP) are usually fine, but note them down. The encoder selection is typically Auto and works best with your GPU.
      • Go to the Applications tab. Sunshine can often automatically detect games installed via Steam, Origin, or Epic Games. For other games or applications, you can manually add them by providing the full path to the .exe file. You can also add custom command lines for specific launch options. Whether you’re streaming a AAA title, an indie gem, or even just your desktop, this is where you define what Sunshine streams.

  2. Network Configuration (The Fuel Lines):

    • Local Network (LAN):
      • This is the simplest setup. Ensure both your host PC and client device are connected to the same local network, either via Ethernet or Wi-Fi.
      • Double-check that Sunshine is allowed through Windows Firewall (as prompted during installation).
      • This provides the most immediate responsiveness and serves as a good benchmark for your ideal streaming performance.
    • Remote Network (WAN): This is where the “annoying parts” truly begin, requiring more complex network adjustments.
      • Port Forwarding: This is critical for connecting from outside your home network.
        • What it is: Port forwarding instructs your home router to direct specific incoming internet traffic (on certain ports) to a particular device (your gaming PC) on your local network. Without it, your router acts like a bouncer, blocking unsolicited external connections.
        • Why it’s needed: Moonlight clients on a remote network need to “find” and communicate with your Sunshine host.
        • Specific ports to forward: You’ll need to forward the following ports from your router to your host PC’s internal IP address:
          • UDP: 47998, 47999, 48000, 48002, 48010
          • TCP: 47984, 47989
        • Router interface navigation: Access your router’s administration page (usually 192.168.1.1 or 192.168.0.1 in a web browser). Look for sections like “NAT,” “Port Forwarding,” “Virtual Servers,” or “Firewall.” The exact steps vary widely by router brand (e.g., Netgear, Linksys, Asus, TP-Link).
        • Static IP for your host PC: For consistent port forwarding, your host PC needs a static local IP address. You can set this in your router’s DHCP reservation settings or manually configure a static IP on your Windows PC. This proves that reliable remote access requires significant network-level intervention beyond simple software installation.
      • Dynamic DNS (DDNS): If your Internet Service Provider (ISP) assigns you a dynamic public IP address (which changes periodically), you’ll need DDNS. Services like DuckDNS, No-IP, or Dynu provide a static hostname (e.g., mygamingrig.duckdns.org) that automatically updates to point to your current public IP. This avoids having to manually update your client’s connection settings every time your public IP changes.
      • VPN (Optional but Recommended): A Virtual Private Network can offer a more secure and sometimes simpler alternative to direct port forwarding.
        • Advantages: It encrypts your connection and can bypass complex port forwarding by creating a secure tunnel to your home network.
        • Setup: Solutions like WireGuard or OpenVPN can be set up on your router (if supported) or directly on your host PC. This shows a more secure, albeit potentially complex, alternative to direct port forwarding.

  3. Client Device Setup (The Driver’s Seat):

    • Install Moonlight: Download the appropriate Moonlight client for your device from its official website or app store.
    • Pairing:
      • On your local network (LAN), open Moonlight. It should automatically discover your Sunshine host. Click on it.
      • Moonlight will display a pairing code. Enter this code into Sunshine’s web UI (under the PIN tab) on your host PC.
      • For remote connections (WAN), Moonlight won’t auto-discover. You’ll need to manually add your host PC’s public IP address or your DDNS hostname.
    • Moonlight Settings: Once paired, explore Moonlight’s settings.
      • Resolution, Bitrate, FPS: Start with conservative settings (e.g., 720p with a low bitrate) and gradually increase them to find the optimal configuration for your network and client device.
      • Video Codec: Experiment with H.264 and HEVC (H.265). HEVC often offers better quality at lower bitrates but requires more powerful client decoding hardware.
      • HDR: Enable this if both your host and client support it for a more vibrant picture.
      • Audio Settings: Configure audio output and consider enabling Stereo Surround for a richer experience.
      • Controller Mapping: Moonlight typically has excellent controller support, but you can adjust mappings here if needed. This shows the granular control you have over the client-side experience, allowing you to tailor it precisely.

  4. First Stream & Input Configuration (The Test Drive):

    • Launch a Simple Game: Start with a less demanding game to test the connection.
    • Test Inputs: Verify that your mouse, keyboard, and controller inputs are registering correctly on the host PC.
    • Adjust In-Game Settings: For optimal streaming, it’s often best to disable V-sync within the game itself and let Moonlight handle synchronization. Also, consider lowering in-game graphics settings if you experience stuttering, especially over WAN.

What Are the Annoying Parts of Moonlight + Sunshine? (The Scraped Knuckles)

While powerful, Moonlight + Sunshine isn’t always smooth sailing. Here are the common frustrations you might encounter:

  • Network Configuration Headaches:
    • Port Forwarding Complexity: This is the biggest hurdle for many. Not everyone has access to their router’s settings, or understands the process. Furthermore, some ISPs use Carrier-Grade NAT (CGNAT), which effectively blocks port forwarding entirely. Strict Wi-Fi networks in places like hotels, campuses, or corporate environments often block the necessary ports, making remote connections impossible without a VPN. This is a common roadblock that highlights the limitations of a direct peer-to-peer setup.
    • Dynamic IP Addresses: Your ISP changing your public IP address can break your remote connection unless you set up and maintain a Dynamic DNS service.
  • Driver & Software Conflicts:
    • GPU Driver Issues: Specific GPU driver versions, especially very new or very old ones, can sometimes cause encoding problems, crashes, or black screens. Rolling back to a known stable driver might be necessary.
    • Antivirus/Firewall Interference: Aggressive security software can mistakenly identify Sunshine’s network activity as malicious and block its communication, even after you’ve allowed it through Windows Firewall.
  • Audio Woes:
    • Virtual Audio Devices: Sometimes, getting game audio to stream correctly, or preventing it from playing simultaneously on both the host and client, requires installing and configuring virtual audio cable software.
    • Microphone Passthrough: Setting up reliable microphone passthrough for in-game chat can be tricky and may require specific client settings or third-party utilities.
  • Controller Support:
    • While Moonlight generally offers excellent controller support, specific controllers or certain games might require manual mapping or the use of third-party tools (e.g., reWASD) to function perfectly. Input latency can also vary, especially over WAN connections.
  • Multi-Monitor Mayhem:
    • Sunshine often defaults to streaming the primary monitor. This can lead to issues if your game is on a secondary monitor or if you want to switch which display is streamed without physically changing your primary display settings.
    • Virtual display drivers might be needed for headless setups (PCs without a monitor connected) or to force specific resolutions not natively supported by your physical display.
  • Updates & Maintenance:
    • Keeping Sunshine and Moonlight updated, along with your GPU drivers, requires manual effort. Not only can an update fix existing issues, but it can also sometimes introduce new ones, demanding further troubleshooting.
  • The “Black Screen of Death”: A common troubleshooting scenario where Moonlight connects to Sunshine but displays only a black screen. This is often due to the host PC’s display sleeping, HDR issues, resolution mismatches between host and client, or a graphics driver crash.

When Should You Consider Another Type of Vehicle?

Moonlight + Sunshine is an excellent solution for many, but it’s not for everyone. It’s a powerful custom racing machine, but sometimes you just need a car that starts with the turn of a key.

  • Complexity Aversion: If the thought of port forwarding, setting up DDNS, and configuring firewall rules makes you groan, a simpler, more managed solution might be better suited for your needs.
  • Network Restrictions: If you’re frequently connecting from restrictive networks (corporate VPNs, hotel Wi-Fi, or if your ISP uses CGNAT), direct Moonlight + Sunshine might be impossible or unreliable due to blocked ports.
  • Cross-Platform Host Needs: Moonlight + Sunshine is a Windows-host-only solution. If you need to stream from a Mac or Linux gaming machine, you’ll need to explore other options.
  • Ease of Setup & Maintenance: For a “set it and forget it” solution with minimal configuration and less ongoing manual maintenance, managed services offer a different approach. For instance, Axiom installs on your Windows PC and connects from any modern browser. It targets 1080p at 60fps (conditions: design target; achieved with hardware encoding on a discrete-GPU gaming PC) with its dedicated gaming mode.
  • Is Moonlight + Sunshine the Right Remote Gaming Setup for You?

If you enjoy tinkering, have control over your home network, and prioritize raw, low-latency performance and extensive client support, Moonlight + Sunshine is an exceptional choice. It’s that powerful custom racing machine that truly rewards your effort.

  • Consider it if: You’re comfortable with technical details, want maximum control over your streaming parameters, and are mainly streaming within your home or from a stable remote location with good network conditions.
  • Look elsewhere if: You need a plug-and-play experience, frequently encounter restrictive networks that prevent port forwarding, or prefer a solution that handles all the underlying network complexity for you without requiring deep technical knowledge.

Just like building that custom racing car, setting up Moonlight + Sunshine requires patience, a willingness to learn, and sometimes, a bit of elbow grease. But when everything clicks, and you’re soaring through your favorite game with minimal latency, the feeling of accomplishment is immense. You’ve built something truly powerful. So, are you ready to get your hands dirty and build your ultimate remote gaming machine?

Here at StreamYourRig, we’re constantly testing the boundaries of remote play. Next up, we’re diving into the performance impact of different VPN protocols on Moonlight + Sunshine latency, looking for every millisecond we can save. Stay tuned!

FAQ Candidates:

  1. Can I use Moonlight + Sunshine without port forwarding?
  2. Why is my Moonlight stream showing a black screen or stuttering?
  3. Does Moonlight + Sunshine support controllers and multiple monitors?