lineageos-fairphone/Guides/2. LineageOsInstallation.md

150 lines
7.2 KiB
Markdown
Raw Normal View History

2021-09-10 11:08:01 +00:00
# Install LineageOS on Fairphone
2021-09-10 11:25:20 +00:00
## 1. Check your prerequisites on your computer
2021-10-22 13:45:04 +00:00
[ ] adb and fastboot are installed on your computer?
[ ] you downloaded the bootimage (img) and LineageOS (zip)?
2021-09-10 11:25:20 +00:00
[ ] you have the unlock code (in case of Fairphone 3)?
[ ] you have an usb cable ready?
2021-10-22 13:50:00 +00:00
[ ] you have removed your screen lock?
[ ] your phone has at least 70% battery?
[ ] you are prepared to erase all the data on your Fairphone?
2021-09-10 11:25:20 +00:00
## 2. Unlock your Fairphone
2021-09-17 09:16:51 +00:00
Unlocking will allow us to overwrite the boot-loader.
2021-09-10 11:25:20 +00:00
1. Navigate to "Settings - About phone"
1. Tap on “Build number” 7 times to enable developer mode
2021-09-10 11:25:20 +00:00
1. Navigate to "Settings - System Advanced Developer options"
1. Enable USB Debugging
2021-09-17 15:06:54 +00:00
1. In case of Fairphone3:
1. Navigate to "Settings - System Advanced Developer options"
1. Enable OEM unlocking with your unlock code
2021-09-10 11:25:20 +00:00
2021-09-10 11:25:20 +00:00
## 3. Connect via usb
2021-09-17 09:16:51 +00:00
For overwriting the boot-loader of your Fairphone, it needs to be connected to your pc.
1. Connect your computer & Fairphone via usb
1. On your Fairphone allow the usb connection
1. Type `adb devices` on your computer (for Windows users: open the terminal in the directory containing adb&fastboot.exe and use the `.\` prefix. The resulting command will be: `.\adb devices`).
2021-09-17 15:44:40 +00:00
The result should show something like
2021-09-10 11:25:20 +00:00
```
List of devices attached
2021-09-13 14:42:01 +00:00
<SerialNumberOfYourPhone> device
2021-09-10 11:25:20 +00:00
```
2021-09-17 10:01:04 +00:00
## 4. Prepare recovery image installation
2021-09-17 09:16:51 +00:00
The next step is critical. If something goes wrong here your Fairphone may remain broken. Time to do some checks:
2021-09-17 10:01:04 +00:00
1. Make sure your phone has at least 70% battery.
1. Reboot your Fairphone to bootloader mode: Type `adb reboot bootloader` on your computer.
1. Your Fairphone should show the bootloader screen.
2021-09-13 14:39:03 +00:00
1. Type `fastboot devices` on your computer. The result should show something like
2021-09-10 11:37:15 +00:00
```
2021-09-13 14:42:01 +00:00
<SerialNumberOfYourPhone> fastboot
2021-09-10 11:37:15 +00:00
```
1. Check your downloaded recovery image
1. In Windows type `Get-FileHash <image_filename.img>` on your computer.
1. in Linux type `sha256sum <image_filename.img>` or alternatively `shasum -a 256 <image_filename.img>` on your computer.
2021-09-17 10:01:04 +00:00
1. The result should look like
```
b6494278d0a399547a9344a6018a30b388f71a97ef52989bcdd661002f3a8631 lineage-18.1-20210906-recovery-FP3.img
```
1. Now compare the number to the one given on the recovery image download page. Ensure you are browsing with "https".
2021-09-17 10:01:04 +00:00
[<img src="img/sha256.png" width="500" height="250">](img/sha256.png)
1. Be aware, in the next step all data will be erased on your Fairphone!
2021-09-17 10:01:04 +00:00
## 5. Install LinegaeOS recovery image
All checks passed? Then lets continues:
1. On your computer type `fastboot oem unlock`.
1. If your Fairphone reboots, you might have to do the steps 2.1-2.4 again to re-enable USB debugging. Then `adb reboot bootloader` will bring you back.
1. Install fastboot image & reboot to recovery
1. For Fairphone2
1. By typing on your computer `fastboot flash recovery <image_filename.img>` (<image_filename.img> is the img-file you have downloaded in 1.).
1. For Fairphone3
1. By typing on your computer `fastboot flash boot <image_filename.img>` (<image_filename.img> is the img-file you have downloaded in 1.).
- If you see something like "boot partition is smaller than boot image" you might find the solution [here](https://gitlab.com/domaindrivenarchitecture/lineageos-Fairphone/-/blob/main/Guides/InstallationFAQ.md).
1. On the phone you should not see any difference and it should remain in the bootloader screen. Then hold Volume Up + Power. Release when boot logo appears.
2021-10-22 14:31:15 +00:00
1. Reboot to Recovery without starting your original rom
1. in case of Fairphone2
2021-11-13 20:27:32 +00:00
1. With the device powered off, hold Power + Volume Up. Release when boot logo appears.
2021-10-22 14:31:15 +00:00
1. in case of Fairphone3
1. Use your bootloader to restart
[<img src="img/start.jpg" width="300" height="400">](img/start.jpg)[<img src="img/recovery.jpg" width="300" height="400">](img/recovery.jpg)
1. Or use the button method, hold Volume Up + Power. Release when boot logo appears.
2021-10-22 14:31:15 +00:00
2021-10-22 14:31:15 +00:00
Please take care not to boot in to your old Android / FairphoneOS. If you missed the proper reboot into recovery by buttons you've to step back to step 1. because your old os reinstall its own recovery over the one just installed.
2021-09-10 11:25:20 +00:00
2021-09-17 09:16:51 +00:00
2021-09-17 10:01:04 +00:00
## 6. Install LineageOS
2021-09-17 09:16:51 +00:00
This step is not very dangerous. You can retry as often you need to.
The LineageOs boot-loader will verify your binaries.
2021-10-11 14:27:04 +00:00
If you are already in the recovery mode you can go to step 6.3.
2021-09-13 16:25:23 +00:00
2021-10-22 14:31:15 +00:00
1. Choose Factory Reset - Format Data/Factory Reset
2021-09-17 09:16:51 +00:00
[<img src="img/reset.jpg" width="300" height="400">](img/reset.jpg)[<img src="img/format.jpg" width="300" height="400">](img/format.jpg)
2021-10-22 14:31:15 +00:00
1. Return to main menu
1. Apply update - Apply from ADB
2021-09-17 09:16:51 +00:00
[<img src="img/apply.jpg" width="300" height="400">](img/apply.jpg)[<img src="img/sideload.jpg" width="300" height="400">](img/sideload.jpg)
2021-10-22 14:31:15 +00:00
1. Type `adb sideload <lineagos.zip>` on your computer (<lineagos.zip> is the zip-file you have downloaded in 1.).
2021-09-17 09:16:51 +00:00
[<img src="img/done.jpg" width="300" height="400">](img/done.jpg)
2021-09-10 11:25:20 +00:00
1. Check whether you see the `Step 2/2` on the bottom of your Fairphone.
2021-09-17 10:01:04 +00:00
2021-09-17 10:01:04 +00:00
### 6.1 Optional installation of Google Apps
2021-09-17 09:16:51 +00:00
If you really need the Google Apps or the Google Play Store there are packages with various scopes, you will find a package comparison here: [https://github.com/opengapps/opengapps/wiki/Package-Comparison](https://github.com/opengapps/opengapps/wiki/Package-Comparison). You have to install Google Apps before the first start.
1. Download your favored version from [here](https://opengapps.org/).
1. Install gapps the same way, you installed LineageOs: `adb sideload <gapps.zip>`
2021-09-10 11:08:01 +00:00
2021-10-12 07:12:52 +00:00
### 6.2 Reboot into LineageOS and prepare for OEM Lock
2021-10-11 13:52:40 +00:00
Rebooting the system should get you straight to LineageOS.
Then do steps 2.1 - 2.4 again to re-enable USB-debugging and boot again into fastboot mode with `adb reboot bootloader`.
## 7. OEM Lock
OEM unlocking / locking will erase all data, so we should ensure to do the lock again now.
1. Type `fastboot devices` on your computer. The result should show something like
```
<SerialNumberOfYourPhone> fastboot
```
1. On your computer type `fastboot oem lock` and enter.
## 8. Start LineageOS
2021-09-17 09:16:51 +00:00
The first start of your new LineageOS - hurray.
1. Walk through the initial setup. If you want to avoid tracking from start, you should
2021-12-18 14:38:03 +00:00
1. execute Step1 - 4 of [DegoogleLineageOs.md](DegoogleLineageOs.md)
2. activate your wlan
2021-09-10 11:08:01 +00:00
## 9. Download the F-Droid App-Store
2021-09-17 09:16:51 +00:00
For installing more software we recommend the F-Droid app store
2021-09-17 09:16:51 +00:00
1. Use the browser on your Fairphone to download F-Droid: [https://www.f-droid.org/](https://www.f-droid.org/)
2021-09-10 12:07:07 +00:00
1. Visit the download-folder and install F-Droid (accept the warning).
1. Do no longer trust your browser for installing apps: Settings -> Apps -> Browser -> extended -> switch "Install from unknown source" off.
1. Now you can install Apps like DeltaChat, NextCloud, Fennec, Tusky, k9 (...) through the F-Droid Store.
2021-12-18 14:38:03 +00:00
## 10. Enable Data-Encryption
Your private data should stay safe in case of loosing your phone
1. Settings -> Privacy -> Trust -> activate encryption (you have to choose at least a screen-lock-pin for this process).
2021-12-18 14:38:03 +00:00
## 11. Final steps
Now your phone is ready for use
1. Disable Development Options: Settings -> System -> Development Options.
2021-12-18 14:38:03 +00:00
1. insert your sim-card