Replicant

h1. Recovery installation or update trough Heimdall

h2. Prerequisites 

In order to install the Replicant recovery on your device, it is assumed that you have a computer running a GNU/Linux operating system and everything necessary to connect your device to the computer through USB. Moreover, it is assumed that anyone performing the installation knows how to use the command line in a terminal and has basic knowledge about it.

h2. Downloading the files

The first step in the installation process is to download and set up the files that will be used to install Replicant to the device. The files must be downloaded on your computer first.

1. First find the recovery latest image for your device in [[ReplicantImages#Images|ReplicantImages]]. For instance for a Galaxy S2, the table will have <pre>Galaxy S 2 (I9100)</pre> in the device column.

2. Then identify the recovery file and its corresponding signature file:

The recovery file will look like that:

<pre>

recovery-<yourdevice>.img

</pre>

And the its corresponding signature file will look like that:

<pre>

recovery-<yourdevice>.img.asc

</pre>

For instance for the Samsung Galaxy S2, the file will be named like that:

* recovery-i9100.img

* recovery-i9100.img.asc

3. Download the latest recovery file and its corresponding signature file for your device on [[ReplicantImages#Images|ReplicantImages]].

4. Make sure you have added the [[ReplicantReleaseKey|Replicant release key]] to your GPG keyring

h2. Check the signature of the recovery

1. From the command line, go inside the directory that has the dowloaded files:

<pre>

cd "${HOME}/Downloads/"

</pre>

2. Then check the signature of the recovery (and don't forget to sure to substitute "<yourdevice>" with the actual device name):

<pre>

gpg --armor --verify recovery-<yourdevice>.img.asc recovery-<yourdevice>.img

</pre>

Make sure the check succeeds, *do not install anything if it doesn't*!

h2. Installing heimdall

The heimdall tool is required to flash the recovery image to the device.

Instructions to install heimdall: [[ToolsInstallation#Heimdall|ToolsInstallation]]

h2. Preparing the device

The next step in the installation process is to prepare the device for heimdall mode.

1. Make sure the device is completely turned off and the USB cable is disconnected from the device

2. Start the device by holding the following key combination: *Volume down, Select, Power*

3. Hold the key combination until the device shows a *Warning* message

4. Confirm that you want to download a custom OS (using volume up)

5. Make sure the device is in *Downloading* mode

4. Connect the USB cable to both the computer and the device

h2. Installing the images

Now that both the computer and the device are set up, it is time to actually install the images to the device.

1. Install the recovery image to the device:

<pre>

heimdall flash --BOOT path/to/recovery-i9300.img --RECOVERY path/to/recovery-i9300.img

</pre>

This should also automatically reboot the device to the recovery.