Prerequisites
What you need before touching anything.
LineageOS is the world's most widely used custom ROM — a clean, close-to-stock build of Android with a huge community. The Pixel 8 Pro (codename husky) is officially supported, with current builds of LineageOS 23.2 (Android 16) maintained by mikeioannina. To install it you need:
- The phone — ideally carrier-agnostic. Carrier variants can have bootloader unlocking disabled by a carrier ID.
- A computer with working
adbandfastboot(from Android platform-tools). - A good USB-C cable, plugged directly into a rear or laptop port — no hubs. Bad cables are the most common cause of failed flashes.
- Patience. LineageOS has no web installer; this is a command-line and recovery process.
Firmware & prep
The exact stock version, and the safety checks before you begin.
- Update to stock Android 16 first. LineageOS 23.2 for the Pixel 8 Pro requires the Android 16 stock firmware installed beforehand. Check the Android version, not the vendor OS version.
- Boot stock at least once and verify the basics — calls, SMS, and mobile data (including over Wi-Fi/LTE if you use it). If something's broken on stock, it will be broken on LineageOS too.
- Remove all Google accounts from the device to avoid Factory Reset Protection locking you out.
- Back up everything. Unlocking wipes the phone, and so does formatting data. Assume nothing survives.
- Enable USB debugging under Settings → Developer options.
Unlock the bootloader
A one-time step that opens the device to custom images.
- Enable OEM unlocking in Developer options, if present.
- Connect the device to your PC over USB.
- Boot into the bootloader. On the computer, run:
adb -d reboot bootloader
Or with the device powered off, hold Volume Down + Power.
- Verify your PC finds the device:
fastboot devices
On Linux, no permissions fastboot means run as root. Empty output means check your cable and port.
- Unlock the bootloader:
fastboot flashing unlock
Confirm any on-screen prompt on the phone. This wipes all data and the secure element.
- Let the device reboot. Since it reset completely, re-enable USB debugging to continue.
Flash the boot partitions
The Pixel 8 Pro needs extra images flashed for recovery to work.
Download the following from the official build page:
boot.imgdtbo.imgvendor_kernel_boot.img
- Power off the device and boot into bootloader mode (Volume Down + Power).
- Flash the images:
fastboot flash boot boot.img
fastboot flash dtbo dtbo.img
fastboot flash vendor_kernel_boot vendor_kernel_boot.img
- Reboot back into the bootloader:
fastboot reboot bootloader
Install Lineage Recovery
A recovery tailored to this device, required for installing the OS.
- Download Lineage Recovery — the file named
vendor_boot.img. Use this one specifically; other recoveries may not work for installation or updates. - Flash it onto the device:
fastboot flash vendor_boot vendor_boot.img
- Reboot into recovery to verify — use the menu to select Recovery. If you don't see the LineageOS logo, you booted into the wrong recovery; start this section over.
Flash LineageOS
Format data, then sideload the OS image.
- Download the LineageOS zip for husky.
- Boot into recovery if you're not already there.
- Select Factory Reset → Format data / factory reset and confirm. This removes encryption and deletes all files in internal storage.
- Return to the main menu.
- Sideload the OS — on the device choose Apply update → Apply from ADB, then on the computer:
adb -d sideload /path/to/lineage.zip
Do not reboot to system yet — finish the rest of the guide first.
Add-ons (optional)
Google Apps, if you want them — before the first boot.
LineageOS ships without Google. If you want the Play Store and Google services, install a Google Apps (GApps) package before first boot.
- Download the arm64 GApps package from the official page.
- Choose Apply update → Apply from ADB, then sideload each add-on in sequence:
adb -d sideload /path/to/gapps.zip
When asked about signature verification, choose Yes — add-ons aren't signed with LineageOS's key, and that's expected.
First boot & verify
Reboot, and know what to expect.
- Click the back arrow, then Reboot system now.
- Wait. The first boot usually takes no longer than 15 minutes. If it drags on longer, you may have missed a step.
- Expect a warning on boot. LineageOS shows a warning every time — there's nothing you can do about it but ignore it. That's normal for a non-stock OS.
- Don't root it via the system partition. LineageOS ships a minimal app set; don't use methods that uninstall system apps, as it can break the system.
What you gain, what you may lose
A fair accounting before you make it yours — LineageOS is a trade, not a miracle.
LineageOS is the most-installed custom ROM on Earth for a reason: it's clean, fast, and endlessly maintained by a huge community. But it sits on a different philosophy than a hardened OS like GrapheneOS — it's about freedom and longevity more than absolute privacy. Here's the honest balance.
What you gain
- Longevity. Official builds and security patches long after your stock update window closes.
- Clean and fast. A near-stock AOSP build with no carrier bloat, no vendor junk, no background Google services unless you add them.
- Huge community. Millions of users, active subreddit, Discord, and IRC — help is almost always a message away.
- Choice of Google. Run it Google-free, or sideload GApps — the decision is yours, and reversible.
- Customizable. A rich set of small improvements and tweaks over stock Android, refined over years.
- Familiar. It feels like stock Android — no learning curve for apps or workflows.
What you may lose
- Google's certification. LineageOS fails Play Integrity, so some banking and DRM apps may block you. Fewer than in the past, but it happens.
- Tap-to-pay. Google Pay often won't work without certified Play integrity. Contactless cards are the fallback.
- Some stock niceties. Pixel-specific features and Google's tuned camera processing may be reduced.
- Verified boot, weakened. Without relocking, the bootloader stays unlocked — the boot warning returns every time, and a physical attacker gains more access.
- Setup is command-line. No web installer; fastboot and ADB are required.
- Privacy is less the point. If you add GApps, Google services run as on stock — not hardened like GrapheneOS.