Using pi-top Hardware with Raspberry Pi OS (formerly Raspbian)

Get up and running with Raspberry Pi OS too! Here's how.

Before we start...

We recommend using pi-topOS, which requires no additional configuration!

Check out About pi-topOS Sirius to learn more about why we think that pi-topOS is the best option for most people.

Adding the pi-topOS software repository


This will allow you to install the latest software from pi-top.
Type the following into a terminal:

echo "deb http://apt.pi-top.com/pi-top-os sirius main contrib non-free" | sudo tee /etc/apt/sources.list.d/pi-top.list &> /dev/null
curl https://apt.pi-top.com/pt-apt.asc | sudo apt-key add

Update package list

This will update your system's records of available software to install.
Type the following into a terminal:

sudo apt update

Install software packages

You are now able to install pi-top software packages.
In most cases, you will want to install all pi-top hardware support software, as this will get your pi-top [1], CEED, [3] or pi-top [4] fully working with Raspberry Pi OS. This means that you'll be able to see the battery level, interact with our accessories (PROTO+, Speakers), and use the pi-top [4]'s Mini OLED Screen menu.
Type the following into a terminal:

sudo apt install --no-install-recommends -y pt-device-manager pt-sys-oled pt-firmware-updater