Before installing /e/OS on the {{device.vendor}} {{device.name }} {{ device.codename }} for the first time, install the latest stock OS version {{ device.before_install_args.version }} build on the device
We suggest installing the latest version of stock OS for {{device.vendor}} {{device.name }} {{ device.codename }}, before installing /e/OS. As per our information the latest stock OS version available is v{{ device.before_install_args.version }}. You can skip this step if you have understood and met the requirements above.
{% endcapture%}
{% include alerts/tip.html content = upgrade_os_version %}
{%- endif %}
{%- if device.revert_to_stock %}
- If you need to revert to stock ROM (vendor provided ROM), Please follow the instructions given in the OS specific guide linked here
{%- if device.revert_to_stock %} - And, remember! You can go back to using stock ROM (vendor provided ROM). Linked below are the instructions to revert to stock ROM on {{ device.name }}. for different operating systems.
{%- for guide in device.revert_to_stock %}
- {{ guide.os | capitalize}} OS [Guide]({{guide.url | relative_url}})
-[{{ guide.os | capitalize}} OS guide]({{guide.url | relative_url}})
{%- endfor %}
{%- endif %}
{%- if device.name == "FP2" %}
{% include alerts/tip.html content = "Please note that the bootloader of the FP2 is unlocked by default."%}
{% include alerts/tip.html content = "The bootloader of {{ device.name }} is unlocked by default. So, you can skip this section"%}
{%-endif %}
{% include templates/unlock_bootloader.md %}
1. Enable OEM unlock in the Developer options under device Settings, if present.
1. Enable `OEM unlock` under `Developer options` in your device's settings (skip this step if your device does not have this option).
1. Connect your device to your PC via USB.
1. Connect your device to your computer using a functional data cable (a charging only cable won't work).
1.On the computer, open a command prompt (on Windows) or terminal (on Linux or macOS) window, and type:
1.Reboot into bootloader (fastboot mode) by entering the command below into a terminal on your computer (also known as a command prompt on Windows):
```
adb reboot bootloader
```
@@ -14,13 +20,13 @@
- {% t devices.with_the_device_powered_off %}
- {% t device.download_boot %}
1. Once the device is in fastboot mode, verify your PC finds it by typing:
1. Once the device is in fastboot mode, find your device by entering:
```
fastboot devices
```
{% include alerts/tip.html content="If you see `no permissions fastboot` while on Linux or macOS, try running `fastboot` as root." %}
{% include alerts/tip.html content="If the command is successful you will be able to see a random ID for your device. Try running `fastboot` as root (or with sudo prepended to the command) if you see `no permissions fastboot`error while on Linux or macOS." %}
1. Now type the following command to unlock the bootloader:
1. Now, let's unlock the bootloader:
```shell
{% if device.custom_unlock_cmd -%}
@@ -30,6 +36,6 @@
{%- endif %}
```
1.If the device doesn’t automatically reboot, reboot it. It should now be unlocked.
1.Your device will reboot if the unlock command is successful. Do a manual reboot if it doesn’t reboot automatically.
1.Since the device resets completely, you will need to **re-enable USB debugging** to continue.
1.At this point your device is completely reset, so you will have to **re-enable USB debugging** to continue. You can follow the guide linked in requirements section above.
## Temporarily Booting a custom recovery using `fastboot`
## Temporarily boot your device into a custom recovery using `fastboot`
1. Download a custom recovery - you can download one [here]({{ device.custom_recovery }}). Download the file named `vendor_boot.img` from the directory named with the latest date.
1. Download a custom recovery [here]({{ device.custom_recovery }}). Download the file named `vendor_boot.img` from the directory named with the latest date.
1. Connect your device to your PC via USB.
1. Connect your device to your computer using a functional data cable (a charging only cable won't work).
1.On the computer, open a command prompt (on Windows) or terminal (on Linux or macOS) window, and type:
1.Reboot into bootloader (fastboot mode) by entering the command below into a terminal on your computer (also known as a command prompt on Windows):
```
adb reboot bootloader
```
1. Once the device is in fastboot mode, verify your PC finds it by typing:
1. Once the device is in fastboot mode, find your device by entering:
The instructions in this guide will assist you to install /e/OS on your {{ device.codename }}. Please read through the instructions at least once before actually following them, so as to avoid any problems later.
{% if device.can_rollback != true %}
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.
{% endif %}
<br><br>
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.
# Important to know
Please read and understand this section before installing /e/OS on your {{ device.name }}.
-**Do not proceed with the steps below** if your device's model dosen't **exactly** match the model number listed at [/e/OS Smartphone Selector](https://doc.e.foundation/devices), where you can hover/click on the device's name to see more information about the device and compare that with your device's model number found in device settings.
- Please flash/install /e/OS on your device **only if you know what you are doing** and **you are okay with taking the associated risks**. We put our best effort to provide good quality /e/OS builds, but all builds come **without any guarantee**. The /e/OS project and its project members deny any and all responsibility of any consequences arising due to installation and usage of /e/OS software and/or /e/OS services.
- Any commands included in this guide won't work if you run them in any wrong directory/folder. The easiset way to avoid any errors is to open the directory/folder in which your files are downloaded and open a terminal/command prompt there using a right-click. Here is a guide for you on how to [Open a Command Prompt or Terminal to a Specific Folder in Windows, Mac or Linux](https://www.groovypost.com/howto/ open-command-window-terminal-window-specific-folder-windows-mac-linux/).
- To get a basic idea of the install process we recommend taking a quick look through the instructions below. You can follow them step wise after you feel confident that you can complete the installation process. Feel free to ask questions on our [community forum](https://community.e.foundation/) if you ever need help.
- 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.
<br>
# Take a Backup
- We strongly recommend you to take a backup of your important data. We further recommend you to store the backup on an external storage device and not on the same device or SD card. Your device data will be deleted during the installation process.
{%- if device.uses_twrp %}
-A guide on backing up with TWRP is available [here]({{ backup_and_restore_with_twrp_link }})
-TWRP users can [backup their device data using TWRP]({{ backup_and_restore_with_twrp_link }})
{%- endif %}
- Ensure your phone is charged more than 50%
<br>
# Meet these requirements
{% if device.can_rollback != true %} - Ensure that your current OS version is below the /e/OS version you are planning to install. You can check that by navigating to Settings -> About Phone. Please beware that downgrading an OS can cause instability or at worst lead to a brick device. {% endif %}
- Charge your phone to at least 50%.
- Download all files listed in the downloads section on your computer.
{%- if device.vendor == "Samsung" %}
-Check that `adb` is enabled on your PC. If not you can find the setup instructions [here]({{ install_adb_link }})
-[Install `adb` tools on your computer]({{ install_adb_link }})
{%- else %}
-Check that`adb` and `fastboot`are enabled on your PC. If not you can find the setup instructions [here]({{ install_adb_link }})
-[Install `adb` and `fastboot` tools on your computer]({{ install_adb_link }})
{%- endif %}
- 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.
{% if device.oem_unlock_code_required %}
- Your device requires a code to unlock the bootloader. Get the code [here]({{ device.oem_unlock_code_required }}) before proceeding with the next steps
{% endif %}
- Enable USB debugging on your device. You can find the instructions [here]({{ enable_usb_debug_link }})
- Make sure that your model is listed in the [Smartphone Selector](https://doc.e.foundation/devices). 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.
{% include alerts/warning.html content="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."%}
- You will need a functional data cable to connect your phone to your computer (A charging only cable won't work).
{% if device.oem_unlock_code_required %} - An unlocked bootloader is required to install /e/OS, and {{ device.name }} requires an unlock code to unlock the bootloader. You can follow these steps to [get the unlock code for your device]({{ device.oem_unlock_code_required }}) {% endif %}
- Turn ON USB debugging from your device settings so your computer can communicate with your device. You can follow our guide on [how to enable USB debugging]({{ enable_usb_debug_link }}).
- Check every functionality of your device on the stock ROM (in most cases this is the current OS you're using).
{% include alerts/warning.html content="Don't forget to check if you can send/receive SMS, and place/receive calls (also via WiFi and LTE, if available). If these basic functions don't work on Stock ROM it won't work on /e/OS as well. Additionally, some devices require that VoLTE/VoWiFi be utilized once on stock to provision IMS."%}
