# Installation d'un CLIC / SOCL
:::info
:clipboard: To do
- tester un nom en .test [x]
- vérifier cryptpad [x]
- vérifier peertube [ko] - impossible de s'authentifier ( Nom d'utilisateur·ice ou mot de passe incorrects. )
- Rédiger le tuto pour la procédure sans **imager**
- Rédiger le tuto de connexion au hotspot
- Réaliser une facilitation graphique du fonctionnement du CLIC
:::
## À quoi sert ce tutoriel ?
L'objectif est d'accompagner l'installation et la configuration du dispositif CLIC sur un [nano-ordinateur](https://fr.wikipedia.org/wiki/Nano-ordinateur) (un Raspberry Pi dans notre exemple).
:::success
:information_source: La proposition de CLIC est de s’auto-héberger (d’installer les services sur son matériel, chez soi) et d’avoir ses outils libres et contenus disponibles localement, et/ou sur le grand Internet avec un système technique pré-configuré.
:::
- L'installation doit être réalisée **avant** d'avoir effectivement besoin du dispositif.
- L'installation nécessite une **connexion Internet**.
- Compter une **demi-journée** (dont une quarantaine de minutes sans besoin d'être devant l'ordinateur) pour l'installation et la configuration.
- Une fois installé et configuré, le dispositif peut s'utiliser hors-ligne (c'est à dire sans être connecté·e à Internet).
## Prérequis
### Pour l'installation
- Disposer d'une connexion Internet, idéalement accessible en filaire (connexion par cable ethernet).
- Disposer d'un ordinateur branché sur secteur.
- Disposer d'un lecteur de carte SD sur cet ordinateur.
- Installer sur cet ordinateur un logiciel permettant de flasher (installer un système d'exploitation) une carte SD : par exemple **imager** de Raspberry Pi : https://raspberry-pi.fr/sortie-raspberry-pi-imager/.
- Disposer d'une carte micro SD (**minimum 8 Go**, recommandé 32 Go et plus si vous souhaitez y héberger beaucoup de données).
- Avoir un logiciel de gestion d'archive (compression et décompression) sur l'ordinateur (par exemple [7-Zip](https://www.7-zip.org/)).
:::warning
:warning: **Il est nécessaire d'installer cette image sur une carte SD** : une clef USB ne permet pas de démarrer un nano-ordinateur.
:::
### Pour la configuration
- Disposer d'une connexion Internet, idéalement accessible en filaire.
- Disposer d'un ordinateur branché sur secteur.
- Disposer d'un nano-ordinateur branché sur secteur.
## Installation
- Télécharger l'image CLIC depuis https://nuage.distrilab.fr/index.php/s/nJXbfgqNLrMn36K sur l'ordinateur :
- Dans la liste de fichiers, sélectionner l'image la plus récente pour **Raspberry pi**, dont le nom est sur le modèle [clic_rpi_AAAA_MM_JJ.img.gz].
- étape optionnelle : vérifier l'intégrité de l'image (voir https://guide.boum.org/tomes/1_hors_connexions/unepage/#index30h2).
- Insérer la carte SD dans le lecteur de l'ordinateur.
### Flasher la carte SD avec Imager
- Sur l'ordinateur, lancer le logiciel **imager**.
- Cliquer sur "Choose OS". (en français)
- Sélectionner "Use Custom".
- Sélectionner l'image sur votre ordinateur (fichier.img.gz).
- Cliquer sur "Choose SD card".
- Sélectionner la carte SD sur laquelle installer l'image.
- Cliquer sur "Write" pour lancer l'installation de l'image.
### Flasher la carte SD en ligne de commande avec dd
Si vous êtes sur GNU/Linux / macOS et que vous êtes familier avec la ligne de commande, il est possible de flasher la carte SD avec dd. Vous pouvez identifier le nom du périphérique avec fdisk -l ou lsblk. Une carte SD s'appelle typiquement /dev/mmcblk0. ATTENTION à bien prendre le bon nom !
Ensuite lancez :
*Remplacez /dev/mmcblk0 si le nom de votre périphérique est différent…*
```dd if=/path/to/yunohost.img of=/dev/mmcblk0 bs=4M status=progress```
- Quand l'installation est terminée (environ 5 min), éjecter la carte SD de l'ordinateur.
## Configuration
- Insérer la carte SD dans le nano-ordinateur.
- Brancher le nano-ordinateur sur le réseau Internet en filaire.
- Mettre le nano-ordinateur sous tension (parfois, il faut simplement le brancher) et patienter le temps du démarrage (environ 5 minutes).
- Dans le navigateur d'un ordinateur branché sur le même réseau (filaire ou wifi), entrer l'adresse "clic.local".
- Accepter les risques de sécurité XXX
- Configurer CLIC à partir de son interface :
- "Domaine principal" :
C’est le nom de domaine qui permettra l’accès au portail d’authentification des utilisateurs depuis le réseau CLIC. Choisissez-en un pour le dispositif sous la forme [lenomdemonclic.test].
:::info
Le nom sert à identifier le CLIC sur le réseau. Vous pouvez mettre ce que vous voulez. Vous pouvez le terminer en :
- .test
- .example
- .invalid
:::
- Dans le champ "Identifiant" :
- Entrer le nom d'utilisateur⋅ice souhaité pour les futures connexions.
- Dans le champ "Nom complet" :
- Entrer le nom qui apparaîtra dans les différentes interfaces du dispositif.
- Dans le champ "Mot de passe" :
- Entrer le mot de passe pour les futures connexions.
- Dans le champ "Mot de passe (confirmation)" :
- Répéter le mot de passe.
:::info
Retenez le mot de passe, par exemple en l'enregistrant dans un gestionnaire de mots de passe.
:::
- Conserver l'activation de "Custom app bundle".
- Cliquer sur le bouton "Allons-y".
Une nouvelle page se charge et présente une barre de progression.
L'installation peut prendre une quarantaine de minutes.
## Utilisation
- Le lien "Aller sur le portail utilisateur⋅ice" permet d'accéder aux applications. Le portail est aussi accessible avec l'adresse [lenomdemonclic.local/yunohost/sso/]
- Le lien "Aller sur l'interface d'administration", permet de configurer le CLIC. L'interface est aussi accessible avec l'adresse [lenomdemonclic.local/yunohost/admin]
### Documentation à venir
Se connecter via le wifi ClicHotspot / ClicHotspot (vous aurez un message comme quoi vous êtes hors connexion sécurisée, c'est normal !!!)
- Déconnecter votre ordinateur de votre réseau internet habituel
- Connecter à nouveau l'ordinateur au wifi proposé par le raspberry (ClicHotspot mdp : ClicHotspot)
- saisir dans votre navigateur l'adresse donnée à votre serveur (votreadresse.test par exemple)
- Vous devez accéder au YesWiki