Install /e/OS on a Vsmart - Joy 3 casuarina

This guide installs /e/OS on your casuarina. Read it through once before you start, so you don’t hit surprises partway in. Downgrading from a newer OS version than the /e/OS build you’re about to install can cause instability or brick some devices — check your current OS version first. Flashing is done at your own risk: /e/OS builds are provided as best effort, without any guarantee, and the /e/OS project takes no responsibility for the consequences.

Requirements

  • Back up your important data to an external storage device — some of the steps below format the phone, wiping any backup left on it.
  • Charge your phone above 50%.
  • Enable adb and fastboot on your PC — setup instructions.
  • Download every file listed in the Downloads section below before you start.
  • Use a real data cable — some cables only charge and can’t transfer data.
  • Enable USB debugging on your device — instructions.
  • Confirm your exact model in the Device Selector: where shown, hover the device name for the supported model number, and check it matches yours exactly.
  • Boot the stock OS at least once and check everything works — SMS, calls, and both over WiFi and LTE if available (some devices need VoLTE/VoWiFi used once on stock to provision IMS). Whatever’s broken on stock stays broken on /e/OS.
Warning: Log out of any accounts (Google, Samsung, Mi Account, etc.) set on the stock ROM before proceeding. Most vendors enable Factory Reset Protection (FRP): after a factory reset, a device that's still signed in will ask for the credentials of that account before it can be used again. Also remove any screen locks.

Downloads for casuarina

community /e/OS A15

Each build includes /e/OS Recovery — no separate download needed.

Not sure which one to pick? See official vs. community builds.

Unlocking the bootloader

These steps only need to be run once per device. Unlocking the bootloader will erase all data on your device — make sure anything you want to keep is backed up (see Requirements above). Not sure what unlocking changes on your device? See Bootloader relocking.

An official method of unlocking the bootloader is not available, but there may be some unofficial methods available. Unofficial methods are not recommended or supported by /e/OS, so use them at your own risk! An unlocked bootloader is required to install /e/OS.

Tip: If you see no permissions fastboot while on Linux or macOS, try running fastboot as root.

  1. Enable OEM unlock in the Developer options under device Settings, if present.

  2. Connect your device to your PC via USB.

  3. On the computer, open a command prompt (on Windows) or terminal (on Linux or macOS) window, and type:

    adb reboot bootloader

    You can also boot into fastboot mode via a key combination:

    • With the device powered off
    • hold Volume Down + Power

  4. Once the device is in fastboot mode, verify your PC finds it by typing:

    fastboot devices

  5. Now type the following command to unlock the bootloader:

    fastboot oem unlock

  6. If the device doesn’t automatically reboot, reboot it. It should now be unlocked.

  7. Since the device resets completely, you will need to re-enable USB debugging to continue.

Installing a custom recovery using fastboot

  1. Connect your device to your PC via USB.

  2. On the computer, open a command prompt (on Windows) or terminal (on Linux or macOS) window, and type:

    adb reboot bootloader

  3. Once the device is in fastboot mode, verify your PC finds it by typing:

    fastboot devices

  4. Flash a recovery image onto your device

    fastboot flash recovery recoveryfilename.img

    Replace the recoveryfilename with the name of the recovery image you downloaded in the previous section

  5. Manually reboot into recovery mode

  • With the device powered off
  • hold Volume Up + Volume Down + Power, then select “Recovery mode” using Volume keys.
Tip: Outdated fastboot releases dropped legacy A/B support, so it might attempt to flash to boot__a / boot__b rather than boot_a / boot_b if you try to flash boot. In this case, you must update fastboot to a release newer than or equal to 31.0.2. Alternatively, you can manually specify which slot to flash to based on what slot fastboot failed to flash to. For example, if fastboot fails to flash to boot__a, you must flash to boot_a.

Steps to install /e/OS using /e/OS recovery

Tip: Use the volume keys to navigate and power key to select
Tip: If your PC is unable to detect your device in adb ..in the /e/OS recovery main screen tap Advanced » Enable adb

On /e/OS Recovery Main Screen:

  1. Select Factory reset
  2. Select Format data / Factory reset option
  3. Next screen will display a warning that this action cannot be undone
  4. Select Format data to proceed or Cancel if you want to go back
  5. If you selected Format data ..the format process will complete
Tip: You will see text in small font on the lower left side of the screen mentioning format progress

The small font text would be similar to this

Wiping data
Formatting/data
Formatting/cache
Data wipe complete
  1. Display will now return to the Factory Reset screen
Tip: Use the volume up key to choose the arrow at the top to go back to main screen

In /e/OS Recovery main screen:

  1. Select Apply Update and in next screen Apply update from adb

  2. In the next screen, the device is now in sideload mode

    Note at this point the Cancel option is highlighted that does not mean you have canceled the action. The device is in adb sideload mode.

  3. On your PC begin adb sideload. Type the below command in a console

    adb sideload downloaded_file_name.zip

    Replace downloaded_file_name.zip with the name of the /e/OS file you downloaded in the previous section

  4. Press enter key on the keyboard to start the sideloading The screen will show the progress percentage…This might pause at 47%

  5. Give it some time

  6. The PC console will now display Total xfer: 1.00x

  7. The phone screen will now display some text with a message similar to

    Script succeeded result was [1.000000]

    This means that the install was successful

  8. Use the volume key to select the back arrow on the top left of the phone screen

  9. Go back to the main screen and select Reboot system now

    The reboot process may take 5 - 10 minutes

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 Joy 3 specific topic on our community forum. To report issues in /e/OS please refer this guide