The Port Guides
Road II

LineageOS

community-built
Tutorial · Mobile OS Installation

Install LineageOS on the Pixel 8 Pro

A calm, step-by-step walkthrough of the official installation process — from stock Android to a clean, close-to-AOSP build, using fastboot, Lineage Recovery, and ADB sideload.

Est. time 30–45 min Level Intermediate Device Pixel 8 Pro (husky)
01

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 adb and fastboot (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.
02

Firmware & prep

The exact stock version, and the safety checks before you begin.

  1. 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.
  2. 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.
  3. Remove all Google accounts from the device to avoid Factory Reset Protection locking you out.
  4. Back up everything. Unlocking wipes the phone, and so does formatting data. Assume nothing survives.
  5. Enable USB debugging under Settings → Developer options.
03

Unlock the bootloader

A one-time step that opens the device to custom images.

  1. Enable OEM unlocking in Developer options, if present.
  2. Connect the device to your PC over USB.
  3. Boot into the bootloader. On the computer, run:
Terminal
adb -d reboot bootloader

Or with the device powered off, hold Volume Down + Power.

  1. Verify your PC finds the device:
Terminal
fastboot devices

On Linux, no permissions fastboot means run as root. Empty output means check your cable and port.

  1. Unlock the bootloader:
Terminal
fastboot flashing unlock

Confirm any on-screen prompt on the phone. This wipes all data and the secure element.

  1. Let the device reboot. Since it reset completely, re-enable USB debugging to continue.
04

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.img
  • dtbo.img
  • vendor_kernel_boot.img
  1. Power off the device and boot into bootloader mode (Volume Down + Power).
  2. Flash the images:
Terminal
fastboot flash boot boot.img
fastboot flash dtbo dtbo.img
fastboot flash vendor_kernel_boot vendor_kernel_boot.img
  1. Reboot back into the bootloader:
Terminal
fastboot reboot bootloader
05

Install Lineage Recovery

A recovery tailored to this device, required for installing the OS.

  1. Download Lineage Recovery — the file named vendor_boot.img. Use this one specifically; other recoveries may not work for installation or updates.
  2. Flash it onto the device:
Terminal
fastboot flash vendor_boot vendor_boot.img
  1. 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.
06

Flash LineageOS

Format data, then sideload the OS image.

  1. Download the LineageOS zip for husky.
  2. Boot into recovery if you're not already there.
  3. Select Factory Reset → Format data / factory reset and confirm. This removes encryption and deletes all files in internal storage.
  4. Return to the main menu.
  5. Sideload the OS — on the device choose Apply update → Apply from ADB, then on the computer:
Terminal — sideload
adb -d sideload /path/to/lineage.zip

Do not reboot to system yet — finish the rest of the guide first.

07

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.

  1. Download the arm64 GApps package from the official page.
  2. Choose Apply update → Apply from ADB, then sideload each add-on in sequence:
Terminal — add-ons
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.

08

First boot & verify

Reboot, and know what to expect.

  1. Click the back arrow, then Reboot system now.
  2. Wait. The first boot usually takes no longer than 15 minutes. If it drags on longer, you may have missed a step.
  3. 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.
  4. 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.
09

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.
After installation · Keep this nearby

First-day checks — and how to go back

Give the phone a few minutes before judging it. Test the things you rely on most while your old phone or backup is still available. If either OS is not a fit, returning to official stock firmware is possible; it is another full wipe, not an in-place undo.

After install

  • Finish updates first. Install the latest system and app updates, then reboot once.
  • Test essentials. Make a call, send SMS/RCS, check mobile data, Wi-Fi, Bluetooth, camera, GPS, alarms and your banking apps.
  • Restore carefully. Bring back photos and contacts before sensitive accounts; re-enrol passkeys, 2FA and eSIMs if required.
  • GrapheneOS: keep the bootloader locked and OEM unlocking disabled after setup. Consider Auditor from a second Android device.
  • LineageOS: expect an unlocked-bootloader warning unless you have verified that your exact device/build supports relocking.

Need to go back?

Do not relock a LineageOS device blindly. An incompatible lock can brick the phone. Follow the device-specific LineageOS recovery or return instructions first.

  • GrapheneOS: use the official web installer, choose the Pixel 8 Pro (husky), and follow its return to stock flow. It downloads and flashes the matching official factory image.
  • LineageOS: use Google’s official Pixel factory image for husky and the current Pixel flashing instructions. Verify the image, flash it, then only lock the bootloader when the official procedure says it is safe.
  • Before flashing: back up again, remove accounts where instructed, charge the phone, use a direct USB connection, and expect the device to be erased.

Sources change as releases change. Always prefer the current official instructions linked below over a cached command or an old video.