adb-install-cert 0.2.2

Install certificates to android system store

adb-install-cert (root required)

This script automatically detect android version and choose preffered way to install certificate to system store.

If you want manually install certificate, see my guide

Usage

After installation, you can plug your device and run:

adb-install-cert --cert ~/path/to/cert.pem

If certificate format detect incorrectly, pass it directly (only der and pem support):

adb-install-cert --cert ~/path/to/cert.crt --cert-format der

By default adb-install-cert automatically select installation mode, based on android version. If you want override it, pass --mode option (see --help or read technical description below for more information):

adb-install-cert --cert ~/path/to/cert.pem --mode temporary

If multiple devices present, you can specify one by serial:

adb-install-cert --cert ~/path/to/cert.pem --device-serial some-serial

As alternative, you can use environment variables, as described here:

ANDROID_SERIAL=emulator-5556 adb-install-cert --cert ~/path/to/cert.pem

Installation

pipx variant:

pipx install adb-install-cert

nix variant:

nix install github:sysraccoon/adb-install-cert

Technical Description

Before Android 10, permanent installation of a certificate is possible by remounting the root directory in read-write mode. These changes may require a device reboot.

Starting with Android 10, the root system is available in read-only mode. To install a certificate, the utility uses remounting /system/etc/security/cacerts directory in tmpfs with a preliminary copy of all existing certificates. After a reboot, the changes will be reset and the utility will need to be reused.

Starting with Android 14, all logic described before used, but also in order for the changes to take effect, the utility updates the state of running processes.