Running digital signage on a Raspberry Pi is a cost-effective and reliable solution. With Luna Screens, all you need is a Chromium browser running in Kiosk mode pointing to our web player.
What You Will Need
A Raspberry Pi (Model 3, 4, or 5 recommended) with power supply
MicroSD Card (8GB or larger)
A monitor or TV screen and HDMI cable
Internet connection (Wi-Fi or Ethernet)
Step 1: Install Raspberry Pi OS
First, you need to install the official Raspberry Pi OS. You can use the Raspberry Pi Imager tool to flash the OS onto your MicroSD card. Choose the standard 'Raspberry Pi OS (with desktop)' option, as we need the graphical interface to launch the browser.
Step 2: Configure Autologin and Network
Once the OS is installed and the Raspberry Pi boots up, complete the initial setup wizard to connect to your Wi-Fi network and ensure the system is up to date.
Make sure your Raspberry Pi is configured to automatically log in to the desktop. This is usually the default, but you can confirm it in the Raspberry Pi Configuration tool under System > Boot / Auto Login.
Step 3: Setup Chromium in Kiosk Mode
To make the Raspberry Pi act as a digital signage player, we will configure the Chromium browser to launch automatically in full-screen (Kiosk) mode and navigate to the Luna Screens web player.
Open a terminal on your Raspberry Pi and edit the autostart file by running:
nano ~/.config/wayfire.ini
Note: On older versions of Raspberry Pi OS (using X11 instead of Wayland), you would edit `~/.config/lxsession/LXDE-pi/autostart`. For bookworm and above using wayfire, you add to `wayfire.ini`.
To disable screen blanking (so your screen doesn't turn off), go to Raspberry Pi Configuration > Display > Screen Blanking and disable it.
Then, to autostart the browser in Wayfire, add the following to `~/.config/wayfire.ini` under the `[autostart]` section:
chromium = chromium-browser --kiosk --noerrdialogs --disable-infobars --no-first-run --ozone-platform=wayland --enable-features=OverlayScrollbar https://player.lunascreens.com
If you are on an older OS using X11 (Bullseye or older), edit `~/.config/lxsession/LXDE-pi/autostart` and add:
@xset s noblank
@xset s off
@xset -dpms
@chromium-browser --noerrdialogs --disable-infobars --kiosk https://player.lunascreens.com
Step 4: Reboot and Pair
Save your changes and reboot your Raspberry Pi. Upon startup, Chromium will automatically open in full-screen mode and load the Luna Screens web player.
You'll be presented with a pairing code on the screen. Log in to your Luna Screens dashboard from another device, add a new screen, and enter this pairing code to link your Raspberry Pi to your account. Your digital signage is now fully set up!