--- title: "Install EasySignage Digital Signage on Raspberry Pi" description: "Learn how to install EasySignage on your Raspberry Pi with our step-by-step guide. Simplify digital signage setup and get started in minutes!" url: https://easysignage.com/help/installation/install-digital-signage-raspberry-pi/ --- # Install EasySignage on Raspberry Pi This guide provides step-by-step instructions for installing and configuring the EasySignage player on a Raspberry Pi, including how to download the software, flash the image, and set up automatic startup. ## Supported Raspberry Pi Players - Raspberry Pi 5 - Raspberry Pi 4 - Raspberry Pi 4 Model B - Raspberry Pi 3 Model A+ - Raspberry Pi 3 Model B+ ## How to Install EasySignage on Raspberry Pi You can set up EasySignage on your Raspberry Pi using one of two installation methods, depending on your needs: ### [Option 1: Flash EasySignage Custom Android 15 Image](#option-1-use-easysignage-custom-android-image) This is the recommended and easiest way. This image is optimized for **Raspberry Pi 4 and 5**, comes with the EasySignage app pre-installed, and ensures maximum performance and stability. ### [Option 2: Install EasySignage on Raspberry Pi OS](#option-2-install-easysignage-on-raspberry-pi-os) For users who prefer to keep Raspberry Pi OS, you can install EasySignage directly. Choose the method that best fits your setup and follow the step-by-step guide below. ### Option 1: Use EasySignage Custom Android Image Using the **EasySignage Custom Android Image** is highly recommended for the best performance and stability. **Why use the custom image?** - Better performance - Custom OS locked down to the EasySignage App - EasySignage App pre-installed - Full support for all EasySignage features - Robust and easy to install, supporting both Raspberry Pi 5 and Raspberry Pi 4 #### 1\. Download the Image - Download the image file for Raspberry 4: [rpi4-aosp15-ez-v1.img.zip](https://download.easysignage.com/rpi/android/rpi4-aosp15-ez-v1.zip) - Download the image file for Raspberry 5: [rpi5-aosp15-ez-v1.img.zip](https://download.easysignage.com/rpi/android/rpi5-aosp15-ez-v1.zip) #### 2\. Flash the Image to an SD Card - Insert a microSD card (32GB or larger recommended) into your computer. - Download the Raspberry Pi Imager from [raspberrypi.com/software](https://www.raspberrypi.com/software/) and run the installer. - Open Raspberry Pi Imager: 1. Click **Choose Device** ![choose raspberry pi device](https://easysignage.com/help/assets/img/installation/rpi/imager.jpg) 2. Select your Raspberry Pi model from the list. ![choose raspberry pi model](https://easysignage.com/help/assets/img/installation/rpi/choose-device.webp) 3. Click **Choose OS → Use Custom** ![choose custom OS](https://easysignage.com/help/assets/img/installation/rpi/use-custom.webp) 4. select **rpi5-aosp15-ez-v1.img.zip** (for Raspberry Pi 5). 5. Click **Choose Storage → select your SD card**. ![choose storage device](https://easysignage.com/help/assets/img/installation/rpi/choose-storage-device.jpg) 6. Click **Next** → In a popup, Imager will ask you to apply OS customisation. Click **NO** button to skip. ![OS customization settings](https://easysignage.com/help/assets/img/installation/rpi/no-customization.jpg) 7. Respond **YES** to the popup “Are you sure you want to continue?”. ![Continue](https://easysignage.com/help/assets/img/installation/rpi/continue-yes.jpg) 8. Click **Write** when an admin prompt ask for permission to allow the Imager to read and write to your SD card. Wait until the flashing is complete, this could take a few minutes. ![Write on storage device](https://easysignage.com/help/assets/img/installation/rpi/write-on-storage.jpg) 9. Click **Cancel Verify** to skip the verification process. ![Cancel Verify](https://easysignage.com/help/assets/img/installation/rpi/cancel-verify.jpg) 10. When you see the “Write Successful” popup, your image has been completely written. You’re now ready to boot a Raspberry Pi from the SD card! ![Write Successful](https://easysignage.com/help/assets/img/installation/rpi/write-successful.jpg) #### 3\. Boot the Raspberry Pi - Insert the microSD card into your Raspberry Pi. - Connect power, HDMI display, and optional USB keyboard/mouse. - The device will boot into **EasySignage Android 15**. * * * ### Connecting to Wi-Fi (Open Android Settings) #### Option A: Using a Keyboard 1. Plug in a USB keyboard. 2. Press **ALT + M**. 3. Enter the default password: **1122**. 4. Select **Open Settings**. 5. Go to **Network & Internet > Wi-Fi**. 6. Connect to your Wi-Fi network. 7. Restart the player once connected. #### Option B: Using a Mouse 1. Connect a USB mouse. 2. Long left-click on the **top-left corner** of the screen for **5 seconds**. 3. Enter the default password: **1122**. 4. Select **Open Settings**. 5. Go to **Network & Internet > Wi-Fi**. 6. Connect to your Wi-Fi network. 7. Restart the player once connected. _That’s it! Your Raspberry Pi is now running **EasySignage Android 15** and ready to use._ * * * ### Option 2: Install EasySignage on Raspberry Pi OS #### Pre Installation steps Download and install Raspberry Pi OS with desktop on your Raspberry Pi Check the below link for more information on how to install Raspberry Pi OS on your device. [Setting up your Raspberry Pi](https://www.raspberrypi.com/documentation/computers/getting-started.html#setting-up-your-raspberry-pi) - **Make sure Chromium browser is installed**: - **Disable Screen Blanking**: - **Step 1:** On the main Raspberry Pi menu, click on Raspberry Pi Configuration under Preferences ![Raspberry-Pi-Configuration](https://easysignage.com/help/assets/img/installation/rpi/Raspberry-Pi-Configuration.webp) - **Step 2:** Click to the “Display”. ![Raspberry-Pi-Display](https://easysignage.com/help/assets/img/installation/rpi/Raspberry-Pi-Display.webp) - **Step 3:** Disable the “Screen Blanking” ![Raspberry-Pi-Screen-Blanking](https://easysignage.com/help/assets/img/installation/rpi/Raspberry-Pi-Screen-Blanking.jpg) #### Installation steps - **Step 1:** Open Terminal as the below: ![Raspberry-Pi-Screen-Blanking](https://easysignage.com/help/assets/img/installation/rpi/open-terminal-on-raspbian.jpg) - **Step 2:** Copy paste the below script into the terminal: For **Raspberry Pi OS (64-bit):** ``` /bin/bash -c "$(curl -fsSL https://appds.io/rpi64.sh)" ``` For **Raspberry Pi OS (32-bit):** ``` /bin/bash -c "$(curl -fsSL https://appds.io/rpi32.sh)" ``` This script will create a folder under your home directory called “digital-signage” and download the player binary, then set up a startup script to start the app on boot time. - **Step 3:** Restart your device by writing reboot in the terminal ``` reboot ``` * * * ## Fix Starting EasySignage on the latest Raspberry Pi OS The latest operating system is configured with the Wayland desktop manager which is causing issues when starting the application in fullscreen mode. To solve the issue, switch from the **Wayland** desktop manager to **X11**. Follow the below steps: 1. Open terminal and run the below command ``` sudo raspi-config ``` 2. Navigate to: 6 Advanced Options ![Raspberry-Pi-Software-configuration](https://easysignage.com/help/assets/img/installation/rpi/raspberry-pi-4-software-configuration-1.png) 3. Choose : A6 Wayland ![Raspberry-Pi-Software-configuration](https://easysignage.com/help/assets/img/installation/rpi/raspberry-pi-4-software-configuration-2.png) 4. Choose : W1 X11 ![Raspberry-Pi-Software-configuration](https://easysignage.com/help/assets/img/installation/rpi/raspberry-pi-4-software-configuration-3.png) 5. Press Ok. You should see the message “Openbox on X11 is active” press Ok. 6. Press finish, and you will be asked if you would like to reboot now; choose Yes. [Previous ##### Install EasySignage on Linux Devices](https://easysignage.com/help/installation/install-digital-signage-linux/) [Next ##### Install EasySignage on Sony BRAVIA Professional Displays](https://easysignage.com/help/installation/digital-signage-sony/)