home/en/Install-on-GNULinux.md

@@ -2,4 +2,58 @@
 
 Go to the [last release](https://gitlab.irstea.fr/theophile.terraz/pamhyr/-/releases/permalink/latest) page and **download the package** for yours system. For GNU/Linux system, get the file `GNU/Linux (tar.xz)` and **extract the archive**. You can now run Pamhyr with path `./pamhyr/pamhyr`.
 
-:bulb: If you are under a Linux distribution with *Wayland* and Pamhyr cannot run, you can run Pamhyr with `pamhyr-x11` script to force *x11* backend.
\ No newline at end of file
+:bulb: If you are under a Linux distribution with *Wayland* and Pamhyr cannot run, you can run Pamhyr with `pamhyr-x11` script to force *x11* backend.
+
+# From sources
+
+In this case, you need to install some dependencies.
+
+## System dependencies
+
+You need *git*, *python3-venv* and *python3-pip* installed on your system.
+
+:bulb: On Debian based distribution (Debian, Ubuntu, Linux Mint, ...):
+
+```shell
+$ sudo apt install python3-venv python3-pip git
+```
+
+## Get Pamhyr2 sources
+
+```shell
+$ git clone https://gitlab.irstea.fr/theophile.terraz/pamhyr
+$ cd pamhyr
+```
+
+## Pamhyr2 dependencies
+
+Now, we can setup the Pamhyr environment, open a terminal and type following command:
+
+```shell
+$ python3 -m venv venv
+$ source venv/bin/activate
+$ python3 -m pip install requirements.txt
+$ deactivate
+```
+
+## Install Mage (optional)
+
+This step consists of installing the default version of Mage from release.
+
+```shell
+$ export MAGE_8_VERSION="v8.3.6"
+$ curl -L -o mage8.tgz https://gitlab.irstea.fr/jean-baptiste.faure/mage/-/releases/$MAGE_8_VERSION/downloads/packages/mage_linux.tgz
+$ mkdir -p mage8
+$ cd mage8
+$ tar xf ../mage8.tgz
+$ cd ..
+```
+
+## Run Pamhyr2
+
+Finally, you can run Pamhyr2 with the command:
+
+```shell
+$ source venv/bin/activate
+$ ./src/pamhyr.py
+```
\ No newline at end of file