CerisWhite / CrAnberry

Rooting the ChromeOS Android Subsystem post v77
Other
40 stars 8 forks source link
android chromebook chromeos container root

CrAnberry

Rooting the ChromeOS Android Subsystem post v77

WARNING: The Android Subsystem in newer versions of ChromeOS seems to have been updated to Android 10, and this script may not work anymore. I do not have a recent device with access to the subsystem, so please open an issue and we can work on it together if this is the case!!

After update v77 of ChromeOS, the android subsystem was updated to version 9 (Pie) and nolirium's aroc project no longer worked. This is a script heavily inspired by their initial work, but much more straightforward and easy to read.

Disclaimer: I am not responsible for any damage caused by this script. Always back up your data (or don't, it's your device)

Disclaimer 2: Right now, rooting requires SELinux must be set to permissive at all times. This is extremely insecure, and as such, you should only run code you absolutely trust using this (but you should have known that anyways).

cranberry.sh

To use it locally, save the cranberry.sh file to your Downloads folder, then copy it to your /usr/local/bin directory, and run sudo bash /usr/local/bin/cranberry.sh

To use it directly, copy and paste the following in crosh:

curl https://raw.githubusercontent.com/CerisWhite/CrAnberry/main/cranberry.sh | sudo bash

This will generate an image at /usr/local/cranberry named "system.rooted.img" and symlink it to /opt/google/containers/android/system.raw.img

revert.sh

This script will undo the changes done by Cranberry. Run it and then reboot to get your original android system without root back. It can be run exactly as above:

curl https://raw.githubusercontent.com/CerisWhite/CrAnberry/main/revert.sh | sudo bash

Notes

The image will not be mounted read-write, like AROC did. With Android 9, it's impossible to mount an active ARC++ image as read-write, period. While you can modify the config.json to tell it to mount the image read-write, the directory /opt/google/containers/android/rootfs/root will remain read-only regardless and cannot be remounted read-write.

You can make changes to a cranberry image by removing the symlink, rebooting, mounting the image manually, making the changes, then replacing the symlink and rebooting again. Manually patching is possible this way (but good luck because I have zero idea how to do that).

If someone can find a way to make a RW system work, please let me know so I can update my information. As of right now, what I know is:

A) Setting the init.rc to mount the system rw causes the image to not load, but it can be undone using the process above.

B) Setting ANDROID_WRITEABLE=true in /usr/arc-setup/config.json will allow an unmodified android image to mount properly, but still be read-only. Doing this with a cranberry image will completely trash it. An image affected by this cannot be salvaged and will need to be recreated after running revert.sh.

IMPORTANT

Because the system cannot be mounted read-write, things that want to patch the system (Lucky Patcher android patches, Xposed, etc.) will not work. Other root apps (GameGuardian, SB Game Hacker) will work just fine, though!

Again: This currently requires SELinux to be set to Permissive at all times. This is very insecure and dangerous. There's also no SU Manager installed in the system per this method as my testing so far has shown that it breaks the image, but I will probably (not) look into it again later on. Installing an SU manager also doesn't work as it requires the system to be read-write to update the su files. Be very very careful about what code you run on your machine.

If you have any questions (or don't want to open a public issue), you can find me on Discord (@ceryphim).