Docs  /  Ubuntu on rooted Google Pixel devices

Ubuntu on rooted Google Pixel devices

Safe default: Ubuntu runs inside Android (Termux + proot-distro).
This does not replace Android, unlock requirements beyond what you already have, or wipe /data.

Approach Wipes phone? Needs Magisk root? Desktop GUI Recommendation
Termux + proot Ubuntu No No (works unrooted too) Optional (VNC / Termux:X11) Use this
Magisk chroot / Linux Deploy No* Yes Possible Advanced
Full Ubuntu Touch / custom ROM Yes Bootloader unlock Native Not supported for Pixel 7 Pro stock dual-boot

* Still risk if misconfigured.

There is no official dual-boot “install Ubuntu as the only OS” path for Pixel 7 Pro that we will automate here — that would destroy the Android install and carrier features. Use proot Ubuntu instead.


Your Pixel 7 Pro (this workspace)

Item Value
Model Pixel 7 Pro (cheetah)
Serial (example session) 28041FDH3002T6
Android 16 · build CP1A.260405.005
Magisk 30.7 (init_boot patch) — see MAGISK_INSTALL_STATUS.md
Ubuntu path Termux proot-distro → distro ubuntu

One-shot from this PC

cd "E:\_AugmentedIntelligence\_src\_AugmentedIntelligence_v11.0 - Typed Commands\tools\android\ubuntu_pixel"
.\Install-UbuntuOnPixel.ps1

Then on the phone, in Termux:

bash /sdcard/Download/install_ubuntu_proot.sh

Enter Ubuntu:

ubuntu
# or
proot-distro login ubuntu

Inside Ubuntu you are effectively root for package installs (apt).


Manual steps (any Pixel)

Prerequisites

  1. USB debugging on (Developer options).
  2. Phone unlocked, USB authorized for this PC.
  3. Enough free space on /data (≥ 4 GB recommended; 8 GB+ comfortable).
  4. Optional Magisk: Superuser → allow Shell if you want adb shell su.
  5. Do not use the Play Store Termux (outdated). Use GitHub/F-Droid builds.

1) Install Termux (host)

$adb = "tools\android\platform-tools\adb.exe"
# APK already downloaded by Install-UbuntuOnPixel.ps1, or:
# https://github.com/termux/termux-app/releases  → arm64-v8a APK

& $adb shell settings put global verifier_verify_adb_installs 0
& $adb install -r -t -g path\to\termux-arm64.apk
& $adb shell am start -n com.termux/.app.TermuxActivity

Open Termux once so it finishes bootstrap.

2) Install Ubuntu (on phone)

pkg update -y && pkg upgrade -y
pkg install -y proot-distro proot wget curl git
proot-distro install ubuntu
proot-distro login ubuntu

Or run the script pushed to:

/sdcard/Download/install_ubuntu_proot.sh

3) Daily use

Action Command
Enter Ubuntu proot-distro login ubuntu or ~/bin/ubuntu
Update packages (inside) apt update && apt upgrade
Install tools (inside) apt install build-essential python3 git
Leave exit
Remove Ubuntu (Termux) proot-distro remove ubuntu

4) Optional GUI (all Pixels)

Termux:X11 or VNC (e.g. tigervnc-standalone-server + XFCE) — large downloads.
Not required for CLI Ubuntu / apt / development.


All rooted Pixel devices (family guide)

Same procedure for every Pixel that is arm64 and can run modern Termux.

Device Codename Magisk partition Notes
Pixel 4 / 4 XL flame / coral boot Older; Magisk patches boot
Pixel 5 / 5a redfin / barbet boot
Pixel 6 / 6 Pro oriole / raven init_boot Tensor
Pixel 6a bluejay init_boot
Pixel 7 / 7 Pro panther / cheetah init_boot This guide’s primary target
Pixel 7a lynx init_boot
Pixel 8 / 8 Pro shiba / husky init_boot
Pixel 8a akita init_boot
Pixel 9 / 9 Pro / XL tokay / caiman / komodo init_boot Confirm factory image before Magisk

Magisk (if not rooted yet)

  1. Unlock bootloader (wipes data once).
  2. Download matching factory image for that device + build.
  3. Extract init_boot.img (Pixel 6+) or boot.img (Pixel 5 and older).
  4. Patch with Magisk app → flash with fastboot flash init_boot / boot.
  5. Reboot; complete Magisk app setup.
  6. Then install Termux + Ubuntu proot (above).

Project reference for P7 Pro Magisk: tools/android/MAGISK_INSTALL_STATUS.md.

Checklist per device

[ ] USB debugging authorized
[ ] adb devices → device (not offline)
[ ] Free space ≥ 4 GB on /data
[ ] Termux (GitHub/F-Droid) installed & bootstrapped
[ ] proot-distro install ubuntu completed
[ ] proot-distro login ubuntu works
[ ] (Optional) Magisk Superuser grant for Shell
[ ] (Optional) Pair with desktop _AI companion app — Pixel7Pro-Install.md

Host one-liner per serial

.\Install-UbuntuOnPixel.ps1 -Serial DEVICE_SERIAL
# then on that phone: bash /sdcard/Download/install_ubuntu_proot.sh

What was automated on the connected Pixel 7 Pro

Step Status
ADB reconnect Device online (cheetah)
Magisk present 30.7 reported (magisk -v)
adb shell su Not granted yet (open Magisk → Superuser → Shell)
Termux APK install Success (com.termux)
Install script on phone /sdcard/Download/install_ubuntu_proot.sh
Ubuntu rootfs download Run in Termux (user must execute script once)

The long package download must run on-device in Termux (network + storage UX). After you run the script once, Ubuntu is ready on that phone.


Pair with _AugmentedIntelligence (optional)

Ubuntu-on-Pixel is independent of the companion app. For the Android agent app:

Desktop:

remote commands start 7710 YOUR_TOKEN
android audio start 7711 YOUR_TOKEN

Uninstall

Termux only

# Termux
proot-distro remove ubuntu

Remove Termux app

adb uninstall com.termux

Does not affect Magisk or stock Android system partitions.


Safety notes

  • Prefer proot over replacing Android.
  • Keep a factory image for your exact build if you experiment with Magisk.
  • Carrier + banking apps may detect Magisk (use DenyList / Zygisk modules at your own risk).
  • Full Ubuntu Touch ports for Tensor Pixels are community experiments — not part of this automated path.
Generated from the project markdown docs on 2026-07-24. This is a static, self-contained site.