Installation d'une CLIC

TODO

  • 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 (un Raspberry Pi dans notre exemple).

En résumé

: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).

Attention !

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


  • Insérer la carte SD dans le lecteur de l'ordinateur.

Méthode 1 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.xz).
    • 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.

Méthode 2 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 :
image install.png (0.1MB)
  • "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].

Information

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. Ce mot de passe devra comporter plus de 8 caractères et comporter majuscules, minuscules et caractères spéciaux.
  • Dans le champ "Mot de passe (confirmation)" :
    • Répéter le mot de passe.

Information

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.
image install1normal.png (55.4kB)
image plante.png (0.1MB)

Vous avez un message d'erreur de type : Running: yunohost tools postinstall -d 'bipbip.local' -p '[REDACTED]' -u 'bipbip' -F 'Mon nom'
iptables/nftables does not seems to be working on your setup. You may be in a container or your kernel does have the proper modules loaded. Sometimes, rebooting the machine may solve the issue.
You are now about to define a new administration password. The password should be at least 8 characters long—though it is good practice to use a longer password (i.e. a passphrase) and/or to use a variation of characters (uppercase, lowercase, digits and special characters).
Command 'yunohost tools postinstall -d 'bipbip.local' -p '[REDACTED]' -u 'bipbip' -F 'Mon nom' &>> ./data/postinstall.logs' returned non-zero exit status 1.
La solution : débranchez, rebranchez le Raspberry et cliquez sur "Réessayer"
L'installation peut prendre une quarantaine de minutes.
image finInstall.png (67.4kB)

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 !!!)