Install /e/OS on a Teracube Teracube 2s (2025) - “sapphire”
The instructions in this guide will assist you to install /e/OS on your sapphire. 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
andfastboot
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.
Please share your experience , suggest tips or changes to this install guide documentation by visiting the Teracube 2s (2025) specific topic on our community forum.
To report issues in /e/OS please refer this guide
Downloads for sapphire
-
/e/OS build : U community
-
/e/OS build : U official
To understand the difference between /e/OS builds check this guide
Enabling USB debugging and OEM unlock
- Connect device to a PC via USB-C cable
- Enable
Developer Options
following the guide given here - Enable
USB debugging
option following the guide given here- Click on
OK
forAllow USB debugging?
prompt - Click on
Allow
forAllow USB debugging?
prompt showing computer’s RSA key fingerprint
- Click on
- Enable
OEM Unlock
option following the guide given here
Booting into fastboot and unlocking bootloader
- Reboot to fastboot using either of two methods (Automatic or Manual)
- Automatic
- From your computer, run
adb reboot bootloader
- From your computer, run
- Manual
- Turn off your phone and enter boot menu by holding
volume up
andpower
keys - The boot menu will present three options, press
volume up
untilBootloader
is selected - Press
power
to accept this choice
- Turn off your phone and enter boot menu by holding
- Automatic
- Unlock the device with the following command
fastboot flashing unlock
- Accept any prompts that may appear on device
- If successful, it will show success message on PC and device
- Reboot the device with the following command
fastboot reboot
Installing /e/OS from the bootloader
- Unzip the archive
unzip <fileyoudownloaded>
Replace
<fileyoudownloaded>
with the name of the archive file you downloaded Alternately, you can create a folder and unzip the archive there - Confirm that extracted directory contains following content:
bin-linux-x86 directory
- which contains linux tools including fastboot and adbbin-msys directory
- which contains Windows tools including fastboot and adbbin-darwin directory
- which contains MacOS tools including fastboot and adbimg files
- Theimg
files to be flashed on the deviceflash_sapphire_factory.sh
- The installer script
- Boot into bootloader/fastboot mode
- Turn off your phone and enter boot menu by holding
volume up
andpower
keys - The boot menu will present three options, press
volume up
untilBootloader
is selected - Press
power
to accept this choice
- Turn off your phone and enter boot menu by holding
- Run the installer script on Terminal(Linux) or on Git Bash UI(Windows)
- Make sure you are in the current directory which contains the
flash_sapphire_factory.sh
file Linux - Right click -> Open terminal here Windows
- Right click -> Git Bash here
- Execute the following command:
chmod +x flash_sapphire_factory.sh && ./flash_sapphire_factory.sh
The script will flash all required files and reboot device automatically
- Make sure you are in the current directory which contains the
Booting into fastboot and locking bootloader
- Reboot to fastboot using either of two methods (Automatic or Manual)
- Automatic
- From your computer, run
adb reboot bootloader
- From your computer, run
- Manual
- Turn off your phone and enter boot menu by holding
volume up
andpower
keys - The boot menu will present three options, press
volume up
untilBootloader
is selected - Press
power
to accept this choice
- Turn off your phone and enter boot menu by holding
- Automatic
- Lock the device with the following command
fastboot flashing lock
- Accept any prompts that may appear on device
- If successful, it will show success message on PC and device
- Reboot the device with the following command
fastboot reboot
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 commandsadb kill-server
andadb start-server
and retry- Running
adb shell twrp install /sdcard/</e/OS zip package>
raise non-existent directory error - Try to check solution here - 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
TWRP
- Errors while running TWRP version 3.4.x.x or above - Try downloading and using a previous TWRP version.. below 3.4.x.x
- In TWRP if this error shows up
failed to mount /preload
- Try in TWRPwipe
screen in advanced menu selectpreload
andswipe to wipe
/cache/recovery/xxx -> no such file or directory
error while flashing a ROM - On PC runadb shell
in the console now create a folder called recovery for e.g. here the devicecode name is violet "violet :/cache# mkdir recovery"
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 2s (2025) specific topic on our community forum.
To report issues in /e/OS please refer this guide