> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pickcel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to install the Pickcel digital signage software on Raspberry Pi?

> Step-by-step guide to flash the Pickcel OS image onto a Raspberry Pi, connect the hardware, and complete the initial Pickcel player setup

<Info>
  **Prerequisites**

  * Raspberry Pi 4 (or newer) with HDMI display, power adaptor, USB keyboard, and mouse
  * MicroSD card (16 GB or higher) with card reader for flashing the Pickcel image
  * Computer running Windows, macOS, or Ubuntu to install Raspberry Pi Imager
  * Stable internet connection for both the setup computer and Raspberry Pi
</Info>

<Steps>
  <Step title="Download the Pickcel Raspberry Pi image">
    Visit [https://www.pickcel.com/download/#raspberry-pi](https://www.pickcel.com/download/#raspberry-pi) and download the Pickcel OS image for Raspberry Pi.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/pi_1.4DlP_apnHs10.png" alt="Download the Pickcel OS image for Raspberry Pi" />
    </Frame>

    <Note>
      [Download Pickcel Raspberry Pi image directly](https://console.pickcel.com/players/raspberrypi/v4/4.0.3/pickcel.img.gz).
    </Note>
  </Step>

  <Step title="Install Raspberry Pi Imager">
    Download the **Raspberry Pi Imager tool** from [https://www.raspberrypi.com/software/](https://www.raspberrypi.com/software/) and run the installer. Proceed through the setup wizard using the default options.

    <Info>
      The Raspberry Pi Imager is available for Windows, macOS, and Ubuntu.
    </Info>

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/pi_2.UFojVqQITU-c.png" alt="Raspberry Pi Imager download page" />
    </Frame>
  </Step>

  <Step title="Launch Raspberry Pi Imager and select your device">
    Open Raspberry Pi Imager and click **Choose Device**.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/pi_3.UpUJXXAjgYmx.png" alt="Click Choose Device in Raspberry Pi Imager" />
    </Frame>

    Pick the Raspberry Pi model you are configuring.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/pi_4.POdoS8UVLdTs.png" alt="Choose Raspberry Pi device model in Raspberry Pi Imager" />
    </Frame>
  </Step>

  <Step title="Select the Pickcel OS image">
    Click **Choose OS**, pick **Custom**, and locate the Pickcel OS image you downloaded earlier.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/pi_5.5a8A6blK7wQx.png" alt="Select the Pickcel OS image in Raspberry Pi Imager" />
    </Frame>
  </Step>

  <Step title="Choose storage and confirm the write options">
    Click **Choose Storage** and select your SD card (ensure the SD card is connected), then click **Next**.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/pi_6.yzKzbM3VJCmj.png" alt="Select SD card storage in Raspberry Pi Imager" />
    </Frame>

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/pi_7.nff8_3eG-h9i.png" alt="Confirm writing the Pickcel OS image" />
    </Frame>

    When prompted, choose **No** for custom settings.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/pi_8.PsAyAKu5uKB9.png" alt="Decline advanced customisation options" />
    </Frame>

    Then choose **Yes** to start writing the image.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/pi_9.f5UWIDNx2HpF.png" alt="Confirm to proceed with writing the image" />
    </Frame>
  </Step>

  <Step title="Finish imaging and prepare your Raspberry Pi">
    Wait until Raspberry Pi Imager completes writing and verifying the SD card. Once done, exit the Raspberry Pi Imager, eject the SD card safely, and insert it into your Raspberry Pi.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/raspberry-pi-17.0x0l9iLx4i2q.jpg" alt="Insert the imaged SD card into Raspberry Pi" />
    </Frame>

    Connect the Raspberry Pi with the HDMI cable, Ethernet cable, and a power adaptor.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/raspberry-pi-18.3DjZXqYn0F7U.jpg" alt="Connect Raspberry Pi cables before powering on" />
    </Frame>
  </Step>

  <Step title="Power on Raspberry Pi and open settings">
    Power on the Raspberry Pi, the **Pickcel boot logo** should appear. Use a keyboard for the initial Wi-Fi configuration.

    <Note>
      If the device is connected over Ethernet with a **DHCP IP** address and **DNS** setup, you may not require any configuration and hence may not need a USB keyboard.
    </Note>

    Press <kbd>Ctrl</kbd> + <kbd>M</kbd> to minimize the Pickcel player. Connect a mouse, right-click, and open **Settings**.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/pi_11.gEcpJjNPJpE3.png" alt="Open settings from the Pickcel player on Raspberry Pi" />
    </Frame>
  </Step>

  <Step title="Navigate localization options">
    After opening the settings menu, use the arrow keys to navigate, <kbd>Enter</kbd> to select, and <kbd>Esc</kbd> to go back. Choose **Localization Options** to begin configuration.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/pi_13.LKod9Sm2gEnU.png" alt="Select localization options in Raspberry Pi settings" />
    </Frame>
  </Step>

  <Step title="Set the timezone">
    Choose **Timezone**, select your geographic area, and pick your timezone city. Click **OK** to confirm and return to the configuration tool.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/pi_14.Bs8SaoFhtQod.png" alt="Choose timezone for Raspberry Pi" />
    </Frame>
  </Step>

  <Step title="Configure keyboard layout and finish localization">
    Reopen **Localization Options** and select **Keyboard**.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/pi_16.ZL4P0THFm1Wl.png" alt="Select keyboard layout for Raspberry Pi" />
    </Frame>

    Choose your keyboard model and layout, then click **Finish** to apply the settings and let the device reboot automatically.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/PI_college.U6DV0Dx3btA8.png" alt="Finish localization configuration and reboot" />
    </Frame>
  </Step>

  <Step title="Open network configuration">
    After the reboot, press <kbd>Ctrl</kbd> + <kbd>M</kbd> to minimize the Pickcel player. **Right-click** and open **Network Configuration**.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/pi_19.IvfrGVCh9Gt4.png" alt="Open network configuration on Raspberry Pi" />
    </Frame>
  </Step>

  <Step title="Activate a network connection">
    In the Network Configuration menu, select **Activate a connection**. Use the arrow keys to navigate, press <kbd>Enter</kbd> to choose an option, and <kbd>Esc</kbd> to go back.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/pi_20.oEqQVs_54G3o.png" alt="Activate a network connection on Raspberry Pi" />
    </Frame>
  </Step>

  <Step title="Connect to Wi-Fi">
    Choose your preferred Wi-Fi network from the list, enter the password, and connect. Once connected, click **Quit** to exit and let the device reboot automatically.

    <Frame>
      <img src="https://cdn.pickcel.com/images/support/player-installation/raspberry-pi/pi_21.kG2lwJa0Ek8B.png" alt="Select Wi-Fi network on Raspberry Pi" />
    </Frame>
  </Step>

  <Step title="Register the Raspberry Pi with Pickcel">
    After the reboot, the Pickcel app launches automatically and displays a **6-digit Screen Registration Code**. Enter this code in the [Pickcel Console](https://console.pickcel.com/) to pair the screen.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/player-installation/raspberry-pi/01-enter-the-pickcel-screen-registration-code.OJZvFopQSeW_.png" alt="Enter the Pickcel screen registration code" />
    </Frame>
  </Step>
</Steps>

<Info>
  Need help registering your Raspberry Pi? Follow the [Screen Registration guide](/screen-registration/screen-registration).
</Info>

<Note>
  **What's Next?**

  * Start [**Uploading Media**](/media/add-media) to your library
  * Create your first [**Composition**](/compositions/compositions) and publish content
  * Configure [**Schedules**](/schedule-and-publish/publish-v4) to automate playback
</Note>