The modern method uses a script called passport-linux:

# On your PC, after connecting via USB
./passport-linux.sh prepare-sd /dev/sdb
./passport-linux.sh install-debian

The script downloads a pre-packaged Debian rootfs, unpacks it to the SD card, and injects a start-linux launcher into the BB10 app menu.

The BlackBerry Passport (released 2014) is a unique smartphone with a square 4.5" 1440×1440 display, a mechanical keyboard, and Qualcomm Snapdragon S4 Pro or MSM8974 (depending on region). Running Linux on a Passport is possible but limited: community projects have explored installing Linux distributions (mostly Android-derived or lightweight GNU/Linux) by replacing or augmenting the device’s Android-compatible runtime layers or via chroot/containers. This article summarizes feasibility, methods, benefits, and limitations.

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:


By: Open Hardware Chronicle | Reading Time: 8 Minutes

In the graveyard of iconic smartphones, few corpses have sparked as much post-mortem curiosity as the BlackBerry Passport. With its radical 1:1 square screen, a tactile physical keyboard that doubled as a capacitated trackpad, and the raw power of a Snapdragon 801 chip, it was a device that refused to follow standards.

When BlackBerry Ltd. officially pulled the plug on BB10 in January 2022, the Passport became a digital paperweight for the average user. But for the tinkerers, the developers, and the keyboard-lovers, a question arose that refuses to die: Can you run Linux on a BlackBerry Passport?

The short answer is yes, but not in the way you run Linux on a Raspberry Pi. The long answer involves kernel hacking, chroots, and a community of stubborn engineers who believe the Passport is the best pocket-sized terminal ever made.

Right now, Linux on the BlackBerry Passport is a labor of love, not a functional solution. It lives in the realm of "proof of concept."

If you have a Passport lying around, it is absolutely worth trying to install a custom kernel or a Linux rootfs just to see that familiar command line scrolling across that beautiful square screen. It’s a glimpse into an alternate reality where BlackBerry pivoted to open source instead of Android.

However, if you want a reliable daily driver, you might be better off keeping the Passport on its native OS as a dedicated MP3 player or note-taking device, or looking toward modern Linux phones like the PinePhone or Librem 5 for your open-source fix.

Have you tried installing Linux on legacy hardware? Let me know your experience in the comments.

BlackBerry Passport remains a piece of legendary hardware, but running a standard Linux distro on it is a complex "holy grail" project for enthusiasts. The Challenge: The Locked Bootloader The primary hurdle is BlackBerry’s locked bootloader

. Unlike many Android devices, the Passport's security is baked into the hardware, making it nearly impossible to flash a custom kernel or a standard Linux distribution. Ways to Experience "Linux" on the Passport

While you can't simply install Ubuntu Touch or PostmarketOS on a retail device, there are a few workarounds: Android Emulation (LineageOS):

There have been experimental breakthroughs using prototype "Do Not Sell" units or hardware modifications (replacing the eMMC chip) to run , which is built on the Linux kernel. Termux & Shells:

On a standard Passport running BB10, you can technically use terminal emulators or ported Android apps to access a Linux-like command line environment for basic scripting and networking. The Zinwa Project:

For those desperate for the form factor with an open OS, projects like

attempt to put non-BlackBerry innards into the Passport chassis, though this is a total hardware swap rather than a software flash. Why People Still Try

The Passport features a unique 1:1 square screen and a touch-enabled physical keyboard that acts as a trackpad. For the Linux community, this represents the ultimate "pocket computer" if only the software were open.

Running Linux on the BlackBerry Passport (codename: Oslo / Passport) is a niche but fascinating project. Thanks to the mainline Linux kernel efforts, this device is one of the few abandoned smartphones that can run a semi-functional desktop Linux environment.

Current Status (2024):


Once Linux is booted, you are greeted by a console login. Most users install a minimal window manager like Sway or i3-wm (since the square screen hates floating windows).

Use Case 1: The Ultimate SSH Machine The Passport’s keyboard is legendary. Using tmux and ssh, you can admin servers from a coffee shop (via Wi-Fi tethering from your real phone). The tactile feedback beats any glass keyboard.

Use Case 2: Offline Writing Install vim, emacs, or nano. Pair a Bluetooth headphone for white noise. Write your novel. The battery lasts six hours in this text-only mode. Export via rsync or Nextcloud.

Use Case 3: Retro Gaming Via the console, you can install RetroArch. The Passport’s square screen is odd for NES games, but Game Boy (original) and Game Gear titles fit perfectly. Map the physical keyboard to buttons for a unique handheld emulator.

Use Case 4: A Real Pager Set up beeper or matrix-commander. Use the Passport as a dedicated chat device for Matrix or IRC. The keyboard is a joy for typing long messages, and the lack of a modern browser means zero distractions.

If you are expecting to flash a vanilla build of Ubuntu Touch or postmarketOS and have everything work perfectly out of the box, I have to stop you right there.

The Passport runs on a Qualcomm Snapdragon 801 (MSM8974). While this chipset is fairly well-documented, the Passport’s unique hardware makes it a difficult candidate for "mainline" Linux support. Specifically, the display.

This is the "true" Linux experience. The Passport (codename Q30) has partial mainline Linux support thanks to the work of the postmarketOS and #linux-msm communities.