The easiest way to identify which OS is running on a Raspberry Pi is to open the terminal and type the command “cat /etc/os-release”. This will display the name and version of the operating system that is currently running on the Raspberry Pi.
Don’t remember which operating system is installed on your Raspberry Pi? Or maybe you got it installed by someone else?
Today, I will show you how you can quickly find the version currently installed on your device.
As a general rule, the Linux distribution name and version are mentioned in the /etc/os-release file. If the command “raspi-config” is installed, then it’s Raspberry Pi OS, and the version is included in the “About” section.
In this tutorial, I’ll show you how to use this command and read the results. I’ll also add a lot more information to help you identify what is running on your Raspberry Pi.
By the way, if you want to unlock all the secrets of the Raspberry Pi, you can check my e-book here. It’s a 30-day challenge, where you’ll learn everything from beginner to master. It includes many project guides to learn by practice.
How to know which Raspberry Pi OS is installed?
The fastest way to know which operating system is installed on a Raspberry Pi is to check the content of the /etc/os-release file. It includes the system name and version in an easy-to-read format.
There are many commands to find the Raspberry Pi OS version installed.
You can even deduct from the wallpaper or the Raspberry Pi model you use.
But the best way to get all the information is to run one command:
- Open a terminal.
If you are on a Desktop version, there is a shortcut in the toolbar, or under Accessories in the main menu.
You can also connect to your Pi with SSH. - Type the following command:
cat /etc/os-release
- You should get something like this:
In this example, it tells me that I’m running Debian 11 (aka Bullseye).
But I know I’m using Raspberry Pi OS and not the real Debian release, so it doesn’t work all the time. Since Bullseye, it’s no longer mentioned Raspbian here (which was the case previously).
To make sure you’re running Raspberry Pi OS and not Debian, you can check this file:cat /etc/apt/sources.list.d/raspi.list
If it exists, and includes the Raspberry Pi Foundation repository, you are on Raspberry Pi OS, with the version specified at the end of the line:
So, in this example, I’m running Raspberry Pi OS Bullseye.
I know it’s a bit confusing with Raspberry Pi OS because it’s so close to the original Debian distribution, but you these two commands should be enough to know for sure which OS and version you use.
Raspberry Pi OS versions history
Raspberry Pi OS is based on Debian. Debian releases a new version every two years or so.
Each version increments the version ID and comes with a new code-name.
Here is a table with the Raspberry Pi OS version history to help you determine if the version you have is old or not.
Debian version | Codename | Release Date |
---|---|---|
7 | Wheezy | 2013-09-27 |
8 | Jessie | 2015-09-28 |
9 | Stretch | 2017-08-17 |
10 | Buster | 2019-07-10 |
11 | Bullseye | 2021-11-08 |
12 | Bookworm | 2023 |
For your information, not all versions are compatible with all Raspberry Pi models. For example, the Raspberry Pi 4 can run only on Raspberry Pi OS 10 or more, and the Raspberry Pi 3B+ requires Raspberry Pi OS 9 or 10, etc.
You can find all the details on Wikipedia.
If you want to update your system from Stretch to Buster for example, you need to update your repository list and upgrade your system:
- Edit your apt sources:
sudo nano /etc/apt/sources.list
- Replace the version name with the latest one.
For example, replace “stretch” with “buster”. - Save and exit.
- Do a complete upgrade of your system:
sudo apt update
sudo apt full-upgrade
I explain everything in details in this article if you want to try: How to Upgrade Raspberry Pi OS to the Latest Version.
There are also subversion IDs for Debian, with regular major updates (bug fixes, security updates, etc.). If you are interested, you can get the exact version installed with:cat /etc/debian_version
In my case, I got “11.4” while writing this article, which was not the latest one.
If you are not up-to-date, you can upgrade it with:sudo apt update
sudo apt upgrade
After that, the same command gives me 11.5 :).
Are you a bit lost in the Linux command line? Check this article first for the most important commands to remember, and a free downloadable cheat sheet so you can have the commands at your fingertips.
Is your Raspberry Pi running a 64 or 32 bits OS?
So, we have seen how to determine which Raspberry Pi version is installed, but you can also look for other details. For example, the previous commands don’t tell you if you are running a 32 or 64 bits version.
To get the current architecture used on your device, you can run this command:uname -m
You’ll get something like:
- If it’s ARMv3 to v7: You are running a 32 bits operating system
- ARMv8 or aarch64: You are on a 64 bits operating system
If your Raspberry Pi model is compatible with a 64 bits architecture, you can download a 64 bits image from there. For now, The Raspberry Pi Foundation doesn’t push this version by default on their website and Raspberry Pi Imager because it’s not compatible with all models.
But if you have a Raspberry Pi 3B+ or more recent, you can use it. There are still a few bugs, but overall, it works pretty well.
If you are a bit lost with all these versions, you should probably read my other article on the topic: Raspberry Pi OS Versions: All Your Questions Answered
And I also have another one focusing on the differences between the 32-bit and 64-bit versions (especially what you can expect from each one): Raspberry Pi OS 64-bit vs 32-bit (Which One To Install?)
Other commands you can try if it’s not Raspberry Pi OS
As you probably know, Raspberry Pi OS (ex Raspbian), it’s not the only operating system that can run on Raspberry Pi. By the way, you can check my 15 favorite operating systems here.
So, if the previous commands don’t work, or don’t include a Raspberry Pi OS version, it’s probably because you are on a different operating system.
If you are on a Debian-like OS, it shouldn’t be an issue, as the command will work and give you all the required information.
For example, the os-release file on Ubuntu contains something like:NAME="Ubuntu"
VERSION="18.04.4 LTS (Bionic Beaver)"
ID=ubuntu
ID_LIKE=debian
PRETTY_NAME="Ubuntu 18.04.4 LTS"
VERSION_ID="18.04"
HOME_URL="https://www.ubuntu.com/"
SUPPORT_URL="https://help.ubuntu.com/"
BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/"
PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy"
VERSION_CODENAME=bionic
UBUNTU_CODENAME=bionic
Debian, DietPi, Kali Linux, etc. should also be pretty easy to identify.
But, to be sure you find the solution in this post, I will give you a few other commands you can try to find the exact OS version:
- LSB Release: print information about the running distribution.
For example, on Debian:lsb_release -a
It displays shomething like:No LSB modules are available.
Distributor ID: Debian
Description: Debian GNU/Linux 9.13 (stretch)
Release: 9.13
Codename: stretch - Kernel version: displays system information.
uname -a
You’ll get a bunch of information like:Linux raspberrypi 5.4.83-v7l+ #1379 SMP Mon Dec 14 13:11:54 GMT 2020 armv7l GNU/Linux
So, it includes the host name, the kernel version, the release date and the architecture.
It should be useful to find some clues about your system.
Have a GUI? Use it to identify the installed OS
If you have a graphic interface, you can often quickly find which distribution you are using. Here is for example, a video with the 4 most popular systems that you can use on Raspberry Pi. See if it looks like yours:
You can often get some info in the settings, under “About” or something like that.
Want to chat with other Raspberry Pi enthusiasts? Join the community, share your current projects and ask for help directly in the forums.
Conclusion
That’s it, I hope you found your answer in this article. Most of the time, Raspberry Pi runs on Raspberry Pi OS, so it should be pretty easy to find the exact version with the information I gave you.
For other operating systems, it might be tricky. As I can’t test all of them, it’s difficult to give you a solution that will work in any case.
If you still have a question, feel free to leave a comment in the community, so that I can try to help you.
Additional Resources
Not sure where to start?
Understand everything about the Raspberry Pi, stop searching for help all the time, and finally enjoy completing your projects.
Watch the Raspberry Pi Bootcamp course now.
Master your Raspberry Pi in 30 days
Don’t want the basic stuff only? If you are looking for the best tips to become an expert on Raspberry Pi, this book is for you. Learn useful Linux skills and practice multiple projects with step-by-step guides.
Download the e-book.
VIP Community
If you just want to hang out with me and other Raspberry Pi fans, you can also join the community. I share exclusive tutorials and behind-the-scenes content there. Premium members can also visit the website without ads.
More details here.
Need help building something with Python?
Create, understand, and improve any Python script for your Raspberry Pi.
Learn the essentials step-by-step without losing time understanding useless concepts.
Get the e-book now.
You can also find all my recommendations for tools and hardware on this page.
How To Quickly Identify Which OS Is Running On Raspberry Pi
The Raspberry Pi is a popular and versatile mini-computer that can run a variety of operating systems. Knowing which operating system is running on your Raspberry Pi can be helpful for troubleshooting and other tasks. Here are some quick and easy ways to identify which OS is running on your Raspberry Pi.
Method 1: Check the Boot Messages
When you boot up your Raspberry Pi, it will display a series of messages on the screen. These messages will include the name of the operating system that is running. For example, if you are running the Raspbian operating system, you will see a message that says “Raspbian GNU/Linux”. If you are running a different operating system, such as Ubuntu, you will see a message that says “Ubuntu”.
Method 2: Check the Desktop Environment
If you are already logged into your Raspberry Pi, you can check the desktop environment to identify which operating system is running. Different operating systems have different desktop environments. For example, Raspbian has the LXDE desktop environment, while Ubuntu has the Unity desktop environment. If you are not sure which desktop environment you are using, you can search online for a list of the different desktop environments.
Method 3: Check the Version Number
Another way to identify which operating system is running on your Raspberry Pi is to check the version number. Different operating systems have different version numbers. For example, Raspbian has version numbers such as “Stretch” and “Buster”, while Ubuntu has version numbers such as “Xenial” and “Bionic”. You can check the version number by running the “cat /etc/os-release” command in the terminal.
Conclusion
Identifying which operating system is running on your Raspberry Pi can be helpful for troubleshooting and other tasks. There are several quick and easy ways to identify which OS is running on your Raspberry Pi, such as checking the boot messages, checking the desktop environment, and checking the version number. With these methods, you can quickly and easily identify which OS is running on your Raspberry Pi.