Install /e/ on a Sony Xperia Z3 Compact - “z3c” (beta)

Tip: Please read through the instructions at least once before actually following them, so as to avoid any problems later.
Warning: Downgrading Smartphones already on Android Q or LineageOS 17.x to Pie or other OS can cause instability or at worst brick some devices
Caution: Flash your device only if you know what you are doing and are OK taking the associated risk. All builds are provided as best effort, without any guarantee. The /e/ project and its project members deny any and all responsibility about the consequences of using /e/ software and or /e/ services.

Requirements

  • Take a backup of all important data on your phone before proceeding.
  • 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
Caution: Before following these instructions please ensure that the device is on the latest Android Stock firmware. This can be done by checking for any OTA updates available in the Updater. If available run them before installing /e/OS

Downloads for the z3c

In case the TWRP for you device does not exist or is not working as expected try this custom recovery

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

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

Special Requirements

Warning: Before following these instructions please ensure that the device is on firmware version 23.5.A.1.291. To discern this, you can run the command adb shell getprop ro.build.display.id on the stock ROM after following the steps under the Requirements header above. If the device is not on the specified version, please follow the instructions below to install it.
Caution: Flashtool version 0.9.19.9 or later is required.
  1. Download and install Flashtool on your machine
    • If you’re are a Windows user of any version, open a file explorer and navigate to C:\Flashtool\drivers folder, then install the drivers found within
    • Additionally, if you are a Windows 8.1 (x64) user you will need a patch found here
  2. Reboot your machine
  3. On the device, navigate to the Settings app, in the System menu, under the About this device listing, and take note of your model number & carrier
  4. Open Flashtool
  5. Click the symbol to download and open XperiFirm (round button on the right) to download the latest firmware for your device
  6. In XPeriFirm, select your device and an appropriate firmware on the middle column with the version 23.5.A.1.291. Then click on the firmware on the right side below Available Firmware and download it
  7. After the download finished, close XperiFirm. Flashtool now automatically recognizes the downloaded files and prepares the image to be flashed
  8. Now click on the lightning symbol (flash device), select Flashmode and click on OK
  9. Select the firmware file you just downloaded above
  10. Check all the boxes under the “Wipe” menu
  11. Click “Flash” ..It may take a few minutes for the flashing progress indicator to pop up
  12. Turn off your phone.
  13. Hold the volume-down button and keep holding while connecting the device to your PC
  14. Once the flashing process has started, release the volume rocker as soon as possible
  15. When the flash finishes, boot up the device and once booted, please proceed with the instructions
Warning: Ensure the USB cable doesn’t come unplugged during the flashing process!

Unlocking the bootloader

Tip: The steps given below only need to be run once per device.
Warning: Unlocking the bootloader will erase all data on your device! Before proceeding, ensure the data you would like to retain is backed up to your PC and/or an online drive
  1. On the device, dial *#*#7378423#*#* (*#*#SERVICE#*#*) to launch the service menu.
  2. Go to service info > configuration and check rooting status - you can only continue if it says Bootloader unlock allowed: Yes.
  3. Connect the device to your PC via USB.
  4. On the computer, open a command prompt (on Windows) or terminal (on Linux or macOS) window, and type:

     adb reboot bootloader
    
  5. Follow the instructions on Sony’s official unlocking website to unlock your bootloader.
  6. Since the device resets completely, you will need to re-enable USB debugging to continue (Settings->About Phone->Build version, and then you can go to Settings->Developer opptions to enable USB debugging).

Booting a custom recovery using fastboot

  1. Before proceeding ensure you have downloaded the custom recovery from the link given in the Download section above

  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 Up and connect the USB cable. The notification light should turn blue.

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

fastboot devices
Tip: If you see no permissions fastboot while on Linux or macOS, try running fastboot as root
Tip: Some devices have buggy USB support while in bootloader mode. If fastboot hangs with no output when using commands such as fastboot getvar .. , fastboot boot …, fastboot flash … try a different USB port (preferably a USB Type-A 2.0 one) or a USB hub

5. Flash a recovery image onto your device by typing

fastboot flash recovery recoveryfilename.img

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

6. Now reboot into recovery to verify the installation.

Installing /e/ from recovery

  1. Before proceeding ensure you have downloaded the /e/OS for your device, from the link given in the Downloads section above

  2. If you aren’t already in recovery mode, reboot into recovery mode by typing the below command in the console of an adb enabled PC

     adb reboot recovery
    
    Tip: You can also do this manually using the below key combination
    • With the device powered off, hold Volume Down + Power
  3. In TWRP return to main menu, then tap Wipe

  4. Now tap Format Data and continue with the formatting process.

    Here a new screen may show where you will have to type Yes and confirm the action by clicking a button.

    Caution: Format Data will remove encryption as well as delete all files stored on the internal storage. Remember to take a backup first. Check Requirements section above.
  5. Return to the previous menu and tap Advanced Wipe.

  6. Select the Cache and System partitions to be wiped and then Swipe to Wipe

  7. Sideload the /e/ .zip package.

    Tip: Sideload requires actions in two places to be done. One on your phone in the TWRP UI and secondly on the connected PC which should have adb enabled. Also note the sideload process while running may stop abruptly around 50%. The console would show a message Total xfer: 1.00x. This would mean that the transfer has successfully completed.
    • On the device in TWRP,

      select Advanced, ADB Sideload, then swipe to begin sideload.

    • On the host machine, in the console , start the sideload of the package by typing
     adb sideload filename.zip
    
    Tip: Change the filename to the name of the file you downloaded
  8. Once installation has finished, return to the main menu, tap Reboot, and then System

Warning: Avoid installing any additional apps or services if suggested by the recovery. They may cause your device to bootloop, as well as attempt to access and or corrupt your data.
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
  • Running adb shell twrp install /sdcard/</e/ 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 TWRP wipe screen in advanced menu select preload and swipe to wipe
  • /cache/recovery/xxx -> no such file or directory error while flashing a ROM - On PC run adb shell in the console now create a folder called recovery for e.g. here the devicecode name is violet "violet :/cache# mkdir recovery"



Tip: To suggest changes to this install guide documentation, please visit the Xperia Z3 Compact specific topic on our community forum. To report issues in the build please refer this guide

This documentation “Install /e/ on a Sony Xperia Z3 Compact - “z3c”” is a derivative of “install LineageOS on z3c” by The LineageOS Project, used under CC BY.