Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit d6632c81 authored by Manoj Nair's avatar Manoj Nair
Browse files

Resolve "Install procedure update for official builds"

parent e8d21248
Loading
Loading
Loading
Loading
+1 −1
Original line number Diff line number Diff line
@@ -67,7 +67,7 @@ install:
- { mode: Murena smartphones }
- { mode: Roll-back, url: "https://support.fairphone.com/hc/en-us/articles/18896094650513-Installing-Fairphone-OS-Manually" }
display_erecovery: false
install_e_file_name: install_e_FP5
install_e_file_name: install_e_official_lock_bootloader
ignore_troubleshooting_tips: true
requirements_file_name: requirements_FP5
verified_boot:
+93 −0
Original line number Diff line number Diff line
{%- assign device = page.device -%}

## Installing /e/OS
{% include alerts/tip.html content="For Windows users, we advise to use Git Bash. For more info about Downloads and Installation see [Official Documentation](https://git-scm.com/about)"%}


- `The {{  device.codename  }}  comes with an anti-rollback feature.` 

- `Please read the paragraph marked 'Caution' in the Requirements section of this guide before proceeding to install /e/OS on your {{  device.codename  }} .`

Let's proceed with the installation:


1. Unzip the file you downloaded from the link in the `Downloads for {{ device.codename }}` 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.

   


1. 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_{{ device.codename }}_factory.sh` - The installer script.

1. Next boot your {{ device.codename }} into bootloader/fastboot mode using this key combination

    - {% t devices.with_the_device_powered_off %}
    - {% t device.download_boot %}

1. 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_{{ device.codename }}_factory.sh` file.
    - To execute the `chmod` command as suggested in the next step you may require root or `sudo` privileges.
  
    - **Linux** 
       - Right click -> Open terminal here
       - Execute the following command which makes the file executable and starts the installation process
       
        
        `chmod +x flash_{{ device.codename }}_factory.sh && ./flash_{{ device.codename }}_factory.sh`
         

    - **Windows**
       - Right click -> Git Bash here
       - Execute the following command which makes the file executable and starts the installation process
       
        
        `chmod +x flash_{{ device.codename }}_factory.sh && ./flash_{{ device.codename }}_factory.sh`
        

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


{% if device.bootloader_relocking %}

## Locking the Bootloader

After you have completed the installation and verified it starts up successfully, you can lock the bootloader on your {{ device.codename }}. This will factory reset your device again.

{% include alerts/warning.html content="The bootloader is lockable in official builds only. The procedure to lock the bootloader will not work on community builds."%}

- `The {{  device.codename  }}  comes with an anti-rollback feature.` 
- `Please read the paragraph marked 'Caution' in the Requirements section of this guide before proceeding to install /e/OS on your {{  device.codename  }} .`


1. Reboot your device into bootloader, via a key combination:
    - {% t devices.with_the_device_powered_off %}
    - {% t device.download_boot %}


1. In the command prompt, lock critical partition with the following command
   - `fastboot flashing lock_critical`
   -  Approve with  <kbd>Volume +</kbd> then <kbd>power</kbd>
  

1. In the command prompt lock the device with the following command
   - `fastboot flashing lock`
   - Approve with  <kbd>Volume +</kbd> then <kbd>power</kbd>


  
1. Now the device will reboot into /e/ OS
 
{% endif %}