For Raspberry Pi systems, Moonlight Embedded is recommended only for Raspberry Pi 3 and earlier. We strongly recommend using Moonlight Qt on Raspberry Pi 4 and newer boards for enhanced functionality, features, and streaming performance.

NOTE: The Raspbian package repository has changed since v2.4.11 was released in early 2020. To update to v2.5.0 and later, you must run the command below to add the new repository.

Run this command:

curl -1sLf 'https://dl.cloudsmith.io/public/moonlight-game-streaming/moonlight-embedded/setup.deb.sh' | distro=raspbian sudo -E bash

Install the package using

sudo apt install moonlight-embedded

Update the package using

sudo apt update
sudo apt upgrade

The newest Raspberry Pi OS defaults to a display driver that doesn't support Moonlight's renderer. You will need to change some configuration on your Pi to resolve this.

If you are running the latest version of Raspberry Pi OS, you MUST run the following commands BEFORE making changes to /boot/config.txt:

sudo rpi-update
sudo reboot

If you do not perform the above steps to update your Raspberry Pi kernel first, following the below steps may prevent your Raspberry Pi from booting!

To fix this, you can edit the /boot/config.txt file:

1. Run sudo nano /boot/config.txt
2. Scroll down using the arrow keys until you see the line that says dtoverlay=vc4-kms-v3d
3. Change that line to dtoverlay=vc4-fkms-v3d
4. Press Ctrl+X, press Y, then press Enter
5. Reboot your Pi