Raspberry Pi

A step-by-step guide for installing TelemetryOS on your Raspberry Pi 4 device


Supply Limitations & Raspberry Pi 5

Raspberry Pi's in early 2024 are still very hard to come by and often command a significant price premium. We do not recommend deploying on this platform due to this, the price to performance ratio really doesn't support using Raspberry Pi's for digital signage anymore.


To successfully install and run TelemetryOS, your system must meet the following prerequisites:

  • Raspberry Pi 4 or compute module 4
  • Minimum of 2GB RAM
  • Minimum of 32GB storage


TelemetryOS Hardware Requirements

TelemetryOS is incompatible with earlier Raspberry Pi versions or systems with less than 2GB RAM or less than 32GB storage.

If you prefer a ready-made solution, consider purchasing a Raspberry Pi kit with TelemetryOS preinstalled from our partner ThePiHut.

Though not covered in this guide, you may install TelemetryOS on a compute module 4, although we haven't performed specific testing in this context.

SD Card

Your Raspberry Pi 4 requires an SD card of at least 32GB. Ensure it's compatible with Raspberry Pi 4 and fulfills the recommended performance criteria.


The Raspberry Pi 4, has limitations in video resolution. Specifically, TelemetryTV doesn't support 4K video playback on these devices. 4K video playback will not work on the Raspberry Pi 4, regardless of operating system used. This is due to chipset performance limitations.


Encode videos at 1080p

For the best experience with TelemetryTV, use videos encoded at 1080p. This ensures high-quality viewing without overloading the Raspberry Pi's hardware, resulting in smooth video playback.

Installation of TelemetryOS on Raspberry Pi 4

Follow the instructions below to install TelemetryOS on your Raspberry Pi 4.


TelemetryTV's Raspberry Pi 4

If you have TelemetryTV's pre-configured Raspberry Pi 4 device, please skip to step 5.

1. Download Image

Please contact TelemetryTV support ([email protected]) for the Raspberry Pi TelemetryOS Image.

2. Download Raspberry Pi Imager

Next, download the Raspberry Pi Imager to write the TelemetryOS image to your SD card.

Raspberry Pi Imager

3. Burn Image to the SD Card

Insert the SD card into your desktop system, install and launch the Raspberry Pi Imager. Follow the instructions under 'Use Custom' to write the TelemetryOS image onto the SD card.

4. Install SD Card on your Raspberry Pi

Once the image is successfully written, insert the SD card into your Raspberry Pi.

5. Boot your Raspberry Pi

Power up your Raspberry Pi and wait for the boot and startup process to complete.


Use the HDMI0 Port

Use the video output next to the power supply (HDMI0) on the Raspberry Pi. The second video output (HDMI1) is only for use when a second screen is connected. This is due to a limitation of the Raspberry Pi.

6. Setup Networking

Upon booting, the configuration screen will be displayed. Here, you can configure the WiFi or Ethernet settingsβ€”we recommend using an Ethernet connection for greater reliability. Ensure the network status is active before proceeding.


Using an Ethernet Connection

If you opt to bypass WiFi and plug in an Ethernet connection instead, the setup screen will auto-advance to the pairing screen after a 30-second timeout.

7. You're Done!

Your device is now ready to be used with TelemetryOS.


Accessing the TelemetryOS Setup Screen

If you need to return to the setup screen at any point, you can right-click to access the application menu or press Ctrl + S on an attached keyboard.

Pair or Provision your Device with Your TelemetryTV Account

After configuring your WiFi settings, a 6-digit pairing code will be displayed on your device. Either use this code to Pair your device with your TelemetryTV account or Provision your device using a USB

Pairing with a Pairing Code

Follow the steps below or check out our Pairing Guide on how to pair your device with your TelemetryTV account

  1. Open your TelemetryTV account on your computer.
  2. Navigate to the devices page.
  3. Enter the 6-digit pairing code displayed on your device.

Provisioning with USB

Follow the steps below or check out our comprehensive Provisioning Guide on how to Provision with USB.