/ansible-grapheneos

An Ansible role for installing GrapheneOs

Primary LanguageShellGNU General Public License v3.0GPL-3.0

About

An Ansible role for installing GrapheneOs.

DISCLAIMER: This script comes with no warranty. You could brick your phone.

This role replicates the steps outlined at: https://grapheneos.org/install/cli#prerequisites as of February 2024.

Assumptions:

  • localhost is a debian-based computer
  • The playbook is running under Ansible 2.13 or higher
  • A GrapheneOS compatible phone is plugged into localhost via USB
  • The phone plugged into localhost via USB is OEM unlocked, and booted to the bootloader

Steps

  1. Install the necessary packages on localhost:
ansible-playbook -K ansible-setup-localhost.yml

The -K prompts for your sudo password, so that libarchive-tools can be installed via apt.

  1. On your phone, unlock OEM.

  2. Plug your phone into localhost via USB

  3. Run the install scripts (1, then 2, then 3)

  4. Optionally, install the additional packages:

ansible-playbook ansible-setup-extras.yml
./4-install-extras.sh