Install /e/OS on a Teracube Teracube 2e (2021) - “emerald”

The instructions in this guide will assist you to install /e/OS on your emerald. Please read through the instructions at least once before actually following them, so as to avoid any problems later.

It is important that you know that downgrading Smartphones on OS versions greater than the /e/OS OS version you plan to install, can cause instability or at worst brick some devices. We recommend that you check your current OS version, before attempting the installation.

It is advisable to flash your device only if you know what you are doing and are ok taking the associated risk. All /e/OS builds are provided as best effort, without any guarantee. The /e/OS project and its project members deny any and all responsibility about the consequences of using /e/OS software and or /e/OS services.

Requirements

  • If required take a backup of all important data from your phone on an external storage device before proceeding.
  • Do not take a backup on the same device as some of these actions will format the device and delete the backup.
  • Ensure your phone is charged more than 50%
  • Check that adb and fastboot are enabled on your PC. If not you can find the setup instructions here
  • Download all the files and images mentioned in the download section below before starting the installation
  • Make sure you have a working data cable to connect your device to the PC. There are cables which are only for charging and do not transfer data.

  • Enable USB debugging on your device. You can find the instructions here
  • Make sure that your model is listed in the Smartphone Selector. Check the model supported. Where available, information on the model supported should show as a pop-up when you hover the cursor on the Device name. The model number supported should be the exact same.
  • Boot your device with the stock OS at least once and check every functionality.
Warning: Before proceeding with the installation, log out of any accounts you may have set on the stock ROM. Also, remove any screen locks that have been set on the device.
Warning: Make sure that you can send and receive SMS and place and receive calls (also via WiFi and LTE, if available), otherwise it will not work on /e/OS as well. Additionally, some devices require that VoLTE/VoWiFi be utilized once on stock to provision IMS.
Caution: Before moving forward, ensure your device is a Teracube 2e (2021). Please look at the serial number under the battery or dial *#06#. If the serial number starts with 2021 (ex: 202111T2Exxxxxx), you are at the right place! If it starts with 2020, please move to Teracube 2e (2020) documentation

Downloads for emerald

To understand the difference between /e/OS builds check this guide

Warning: Please note some of the above links can lead to external sites

Unlock the bootloader

Caution: Please take a backup of your data as unlocking the bootloader will reset your device to factory defaults.
  1. Enable USB debugging and Allow OEM Unlock following the guide given here
  2. Reboot in fastboot.

  3. You can follow either of two methods (Automatic or Manual) to continue. We give details of both the methods below. Only one needs to be selected

    • Automatic
      • From your computer, run

        adb reboot bootloader

    • Manual
      • Turn off your phone and start it with power + volume up keys.
  4. The menu will present three options, press volume up until Bootloader is selected. Press volume down to accept this choice.

OEM unlock the device

  1. Once your phone is in fastboot mode, on your PC type in a console the below command

    fastboot flashing unlock

  2. Press volume up on your phone to accept.
  3. The device will reboot automatically after an unlock.

Installing /e/OS

Tip: For Windows users, we advise to use Git Bash. For more info about Downloads and Installation see Official Documentation

Let’s proceed with the installation:

  1. Unzip the file you downloaded from the link in the Downloads for emerald section above.

     unzip <fileyoudownloaded>
    

    In the command given above, replace <fileyoudownloaded> with the name of the file you downloaded. You can unzip the file using a File Manager/File Explorer.

  2. Confirm that the folder where you unzipped the files contains the following :

    • bin-linux-x86 directory - which contains linux tools including fastboot and adb
    • bin-msys directory - which contains Windows tools including fastboot and adb
    • .img files - The .img files that are to be flashed onto the device.
    • flash_emerald_factory.sh - The installer script.
  3. Next boot your emerald into bootloader/fastboot mode using this key combination

    • With the device powered off
    • hold Volume Up + Power to open the menu. Use Volume Up and Volume Down to navigate and Power to select. Select Bootloader option
  4. Now we will run the installer script in a terminal on a Linux PC or in Git Bash UI if the desktop OS is Windows.

    • Make sure you are in the current directory which contains the flash_emerald_factory.sh file.
    • To execute the chmod command as suggested in the next step you may require root or sudo privileges.

    • Linux
      • In the folder right click -> open terminal here
      • Execute the following command which makes the file executable and starts the installation process

      chmod +x flash_emerald_factory.sh && ./flash_emerald_factory.sh

    • Windows
      • In the folder right click -> open Git Bash here
      • Execute the following command which makes the file executable and starts the installation process

      chmod +x flash_emerald_factory.sh && ./flash_emerald_factory.sh

  • After installing all the required files the device will reboot.

Locking the Bootloader

After you have completed the installation and verified it starts up successfully, you can lock the bootloader on your emerald.

Warning: Running the below commands will factory reset your device and wipe all data.
Warning: The bootloader is lockable in official builds only. The procedure to lock the bootloader will not work on community builds.
  1. Reboot your device into bootloader, via a key combination:
    • With the device powered off
    • hold Volume Up + Power to open the menu. Use Volume Up and Volume Down to navigate and Power to select. Select Bootloader option
  2. In the command prompt, lock critical partition with the following command
    • fastboot flashing lock_critical
    • Approve with Volume + then power
  3. In the command prompt lock the device with the following command
    • fastboot flashing lock
    • Approve with Volume + then power
Success: Congratulations !! Your phone should now be booting into /e/OS !!
To find some troubleshooting tips… click here

adb

  • Getting a Total xFer ':' 0.01x message - Try to upload the /e/OS to internal storage and retry to install
  • adb ':' sideload connection failed ':' insufficient permissions for device error - Try to execute the commands adb kill-server and adb start-server and retry
  • Getting an insufficient permissions error - Try the solution given here
  • When running "adb devices" in bash a device is shown as "unauthorized" - Try the solution given here

Connectivity

  • Trying to troubleshoot mobile connectivity issues - Read this guide



Please share your experience , suggest tips or changes to this install guide documentation by visiting the Teracube 2e (2021) specific topic on our community forum.

To report issues in /e/OS please refer this guide