See the ToolsInstallation page for how to install adb.
In the settings, open Developer options. In the Debugging section, enable Android debugging.
Authorizing the device¶
In order to allow your host computer to access ADB on the device, it must be allowed on the device. A window should pop up when connecting USB, asking whether to allow USB debugging.
Note: when booting with USB plugged in, the window doesn't pop up and you have to disconnect and reconnect the USB cable to see it happen.
Accessing root shell¶
Once allowed, you can access the device shell using:
The shell is running as an unprivileged user.
To allow root access, open the Developer options in the settings. There, press Root access. In the pop-up menu, select either ADB only or Apps and ADB. A window with "Allow root access?" might pop up and explains the security tradeoffs of enabling root access. After reading the text, select OK to enable root access.
To finally gain root access, use:
The following shells will then be run as root.
Modifying the system partition¶
Replicant is installed on the system partition. By default with most devices, this partition is mounted as read-only and can't be modified.
You can mount the partition as writable filesystem using:
/system/ can now be edited.