> For the complete documentation index, see [llms.txt](https://scorp-io.gitbook.io/guide-to-scorp-io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://scorp-io.gitbook.io/guide-to-scorp-io/module-connecter/software/linux-ubuntu.md).

# Linux - Ubuntu

L'installation du module Connecter se fait grâce à l’exécution d'un script qui permet d'installer tous les composants nécessaires à son bon fonctionnement.

## Lien de téléchargement

### Installation

<details>

<summary>Étape n°1 : installation Docker Engine</summary>

Si Docker n'est pas installé sur votre machine, effectuer l'installation du docker engine avec les commandes suivantes dans le terminal :&#x20;

* Mettre à jour la date si besoin

```
 sudo date <MMDDHHmmAA>
```

* Exécuter dans un terminal

```
sudo apt-get update
```

* Exécuter dans le terminal

```
sudo apt-get install \
ca-certificates \
curl \
gnupg \
lsb-release (O/n --> O)
```

* Exécuter dans le terminal

```
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
```

* Exécuter dans le terminal

```
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```

* Exécuter dans le terminal

```
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin (O/n --> O)
```

* Exécuter dans le terminal

```
sudo service docker start
```

* Exécuter dans le terminal (pour vérification du  bon fonctionnement)

```
sudo docker run hello-world
```

</details>

<details>

<summary>Étape n°2 : installation Docker Desktop</summary>

Suite aux opérations précédentes, nous devons à présent effectuer l'installation de docker desktop avec ces commandes suivantes :&#x20;

* Installer le DEB package sur le site internet de Docker

```
https://docs.docker.com/
```

* Exécuter dans dans le terminal

```
sudo apt-get update
```

* Exécuter dans le terminal (selon la version qui a été installée)

```
sudo apt-get install ./docker-desktop-<version>-<arch>.deb (O/n --> O)
```

</details>

<details>

<summary>Étape n°3 : lancer Docker Desktop</summary>

Suite à l'installation précédente, vous pouvez lancer docker desktop à l'aide des commandes suivantes :&#x20;

* Exécuter dans le terminal

<pre><code><strong>systemctl --user start docker-desktop
</strong></code></pre>

</details>

[Cliquez ici pour télécharger le fichier d'installation du module Connecter](https://scorpio-mail-template-prod.s3.fr-par.scw.cloud/install.sh)

<details>

<summary>Étape n°4 : script SCorp-io</summary>

Une fois docker desktop fonctionnel, installez le module de connexion avec ces commandes suivantes :&#x20;

* Téléchargez le script SCorp-io grâce au lien ci-dessus
* Déplacer le script dans le dossier de votre choix
* Aller dans *Propriétés du fichier* --> Permissions --> Exécution --> **✓**&#x20;
* Exécuter dans un terminal

```
chmod +x nomdufichier
```

* Exécuter dans le terminal

```
./nomdufichier
```

* Exécuter dans la zone de saisie après <\<Project ID :>> dans le terminal

```
votreidSCorp-io
```

* Exécuter dans la zone de saisie après <\<Datebase user :>> dans le terminal

```
votrenom
```

* Exécuter dans la zone de saisie après <\<Datebase password :>> dans le terminal

```
votremotdepasse
```

* Exécuter dans le terminal

```
sudo docker swarm init --advertise -addr 127.0.0.1
```

* Exécuter dans le terminal (pour contrôle)

```
sudo docker ps
```

</details>

<details>

<summary>Étape n°5 : connexion au site</summary>

Une fois l'étape précédente terminée, connectez-vous à l'interface web du module :&#x20;

* Ouvrir un navigateur web et entrer l'adresse suivante dans la barre d'adresse :

```
http://127.0.0.1:8084/
```

* Créez un compte
* Connectez le projet correspondant à votre site

</details>

<details>

<summary>Étape n°6 : configuration du module</summary>

Une fois connecté sur le site, configurez la connexion entre les automates et équipements terrain et le module :&#x20;

* Lier un projet
* Connecter un équipement
* Éditer les données d'acquisition

</details>