Once you are logged in, you have a pure Linux environment.
1. Package Management (Alpine Linux) Open the terminal (King's Cross in Phosh) or SSH in.
sudo apk update
sudo apk upgrade
2. Screen Scaling The Passport has a unique 1:1 square screen (1440x1440).
3. Hardware Acceleration (Advanced) Out of the box, the UI is rendered by the CPU (software rendering). This is slow and drains battery.
There are two ways to install: pmbootstrap (build it yourself, harder) or Pre-built Images (easier). We will use the pre-built method.
Step 1: Download the Image Go to the postmarketOS download page for Blackberry Passport (blackberry-passport). Choose the interface:
Download the .img.xz file.
Step 2: Extract and Write
Step 3: Flashing to Internal Storage
The Reliable Method (Kernel + Rootfs):
The image you downloaded usually contains both the boot partition and the rootfs. It is easier to write the image directly to the userdata partition using dd, but this requires a specific recovery environment.
Current Simplified Method: Most modern pmOS images allow flashing via:
sudo fastboot flash boot pmOS-blackberry-passport-boot.img
sudo fastboot flash userdata pmOS-blackberry-passport-root.img
(Note: If you downloaded a single .img file, you cannot flash it directly via fastboot if it is large. You usually need to use pmbootstrap to install, or split the image).
Alternative: Booting from SD Card (Easier/Safer) If internal flashing fails due to size limits:
In 2015, a developer named Cobalt (famous for patching Google Play Services onto BB10) and later The Mister created a toolset that turned the Passport into a "GNU/Linux Hub."
The recent resurgence in 2024-2025 came from the BB-Linux project (available on GitHub). This project provided a streamlined script to install Debian Bullseye (11) or Bookworm (12) onto the Passport’s SD card or internal storage. linux on blackberry passport
Before we get into the weeds, we must address the "why." The BlackBerry Passport has three unique physical attributes that make it desirable for a Linux environment:
The BlackBerry Passport died as a commercial product because it was too weird. But weirdness is the currency of the open-source community. By forcing Linux onto this square brick, you aren't recovering a dead platform—you are building a monument to what could have been.
If you long for a pocket computer that removes the web, removes the ads, and returns you to the command line, fire up the bbdb tools and wipe the dust off that Passport.
$ sudo apt update && sudo apt upgrade -y
Your keyboard is waiting.
Have you successfully run Debian on your Passport? Share your .bashrc configurations in the comments below.
The Square Frontier: Reviving the BlackBerry Passport with Linux
The BlackBerry Passport, released in 2014, remains one of the most distinctive pieces of mobile hardware ever designed. With its perfect 1:1 aspect ratio screen and a capacitive physical keyboard, it was the ultimate tool for the "power professional." However, following the End of Life (EOL) for BlackBerry 10 services in early 2022, these devices were largely relegated to desk drawers. Today, a dedicated community of enthusiasts is attempting to breathe new life into this "square frontier" by porting Linux, transforming a defunct enterprise tool into an open-source mobile workstation. The Hardware Appeal
The Passport’s enduring allure for Linux users lies in its unique physical attributes:
The Capacitive Keyboard: The physical keys provide tactile feedback essential for command-line efficiency, while the capacitive touch layer allows the keyboard to act as a trackpad—a feature that mimics the functionality of a laptop.
Industrial Design: With a stainless steel frame and 3450 mAh battery, the device feels like a rugged, pocketable terminal. Current Methods of Implementation
Bringing Linux to the Passport is not a straightforward process due to BlackBerry's historically locked bootloaders. Enthusiasts have developed three primary pathways:
Virtualization & Chroot:Many users run Linux distributions like Kali Linux or Ubuntu inside the native BB10 environment using tools like BerryFarm. This method utilizes a fork of the RISC-V 32-bit Linux kernel or a semi-network adapter bridge to run Linux utilities as a "guest" within the QNX-based host.
Remote Desktop (RDP):A common "simulated" Linux experience involves using an optimized RDP client to log into a powerful remote Linux server. This bypasses the Passport’s aging hardware limitations, allowing it to act as a thin client for modern desktop environments. Once you are logged in, you have a pure Linux environment
Native Development (The "Holy Grail"):Developers are working on compiling the V8 engine and modern Python (v3.11) natively for BB10's QNX roots. While a full native "over-the-top" Linux installation remains a challenge due to driver blobs for the GPU and keyboard, progress in creating custom Linux images for the device continues in hobbyist circles. Challenges and the Path Ahead
Running Linux on BlackBerry Passport: A Comprehensive Guide
Abstract
The BlackBerry Passport, released in 2014, was a unique smartphone that featured a square-shaped touchscreen display and a physical QWERTY keyboard. While it ran on BlackBerry's proprietary operating system, there is a growing interest in running Linux on this device. This paper provides an in-depth exploration of the possibilities and challenges of running Linux on the BlackBerry Passport. We will discuss the device's hardware, the boot process, and the steps required to install and run Linux.
Introduction
The BlackBerry Passport, with its distinctive design and feature set, has attracted a dedicated following among enthusiasts and developers. While the device was originally designed to run BlackBerry OS 10, the open-source nature of Linux and the availability of community-driven projects have made it possible to run Linux on this device. This paper aims to provide a comprehensive guide for those interested in exploring Linux on the BlackBerry Passport.
Hardware Overview
The BlackBerry Passport features a:
Boot Process
The BlackBerry Passport uses a UEFI (Unified Extensible Firmware Interface) boot loader, which is responsible for loading the operating system. The UEFI firmware is stored in a dedicated partition on the device's internal storage.
Installing Linux
To install Linux on the BlackBerry Passport, several steps are required:
Linux Distributions on BlackBerry Passport
Several Linux distributions have been adapted to run on the BlackBerry Passport, including: Troubleshooting Common issues and solutions:
Challenges and Limitations
Running Linux on the BlackBerry Passport presents several challenges and limitations:
Conclusion
Running Linux on the BlackBerry Passport is a complex and challenging process, requiring a deep understanding of the device's hardware and software. While several Linux distributions have been adapted to run on this device, there are still significant hurdles to overcome. This paper has provided a comprehensive guide for those interested in exploring Linux on the BlackBerry Passport.
Future Work
Future research and development efforts could focus on:
References
Appendix
Bootloader Unlocking
The bootloader can be unlocked using the following steps:
Linux Kernel
A compatible Linux kernel can be obtained from the following sources:
Linux Distribution Installation
The installation of a Linux distribution can be performed using the following steps:
Troubleshooting
Common issues and solutions:
Help ?
If you are already a member of our network and need to keep track of any developments regarding a question you have already submitted, click "take me to my Query."