Introducing /e/OS Generic System Images (GSI)

An /e/OS Generic System Image (GSI) has been a long standing request from /e/OS users. In this article, we’ll share details about the official /e/OS GSI, which will be released soon.

We assume that the reader has an average knowledge of technical terms, as there are some peppered across this blog post. It would not be possible to explain all the terms and definitions, though we have attempted to keep the narrative as simple as possible.

What is a GSI ?

The official definition for a GSI defines it as:

… a system image with adjusted configurations for Android devices. It’s considered a pure Android implementation with unmodified Android Open Source Project (AOSP) code that any Android device running Android 8.1 or higher can run successfully.

In layman terms, it means that a GSI is a slightly modified system image. It is made from the base Android source code. That being said there are considerable differences between a stock ROM and a GSI. Lets look at some of these.

Regarding /e/, a GSI is an easy way for users or developers to test /e/OS on potentially any recent Android smartphone with an unlockable bootloader.

The difference between GSI and Stock ROMs

What is Project Treble?

To address this problem Google came out with an innovative idea: separate the Operating System code from the device hardware code. This, in a sentence, is the idea behind Project Treble. Now every time an OS update comes along, the device manufacturers do not have to wait for the hardware component code to be upgraded. They are free to push the new Operating System to the end user.

In general we consider devices which came after 2018 and with Oreo or higher as the initial Operating System, are Project Treble- compatible. There could be exceptions to this rule. Let us see what more requirements need to be met.

System requirements for a GSI

The device:

  • should be Project Treble- compatible
  • should have an unlockable bootloader
  • should have been launched with Oreo or a newer OS version
  • was upgraded to Oreo and modified to be Project Treble compatible
  • does not have Xposed framework, SuperSu or Magisk
  • has the stock ROM working on it

The list and variables goes on as technical minds modify and tweak older devices to make them compatible, but we will not go into those details here.

All about /e/’s GSI

We are pleased to announce that the /e/ team resumed building GSIs, based on the work of PHHusson and AndyCGYan. Thanks to these efforts, we are now releasing the official /e/OS GSI.

What the /e/OS GSI is not

  • The GSI is not to be used on a daily driver device
  • Not all hardware components would work on it. For example the bluetooth or camera may not work with the GSI on a particular device
  • Do not expect all software applications to work
  • There will be no OTA updates for the /e/OS GSI at present
  • Use it only for testing purpose …to get a feel of how /e/OS works

User checklist before installing a GSI

  • Check if your device is Project Treble ready
  • You can check this by installing a third party app called “Treble Info”
  • The app should tell you if your device is Treble compatible. If your device is not treble compatible, then you won’t be able to install a GSI
  • Under the section “Required Image” please note the image name to download
  • Under “Dynamic Partitions” check if you require fastboot

How to get your hands on an /e/ GSI

Feedback and comments

For more updates on the project, follow us on Twitter & Mastodon!

A blog maintained by the /e/Os Development Team https://e.foundation/