====== Snappymail - Client webmail ======

Le service https://mail.numenaute.org permet de consulter ses mails. Ce n'est PAS un service d'hébergement de mails, uniquement de consultation. 

<WRAP center round help 100%>
**C'est quoi la différence ?**

L'hébergeur de mail stocke vos mails. Il est souvent associé à un nom de domaine précis, par exemple Gmail, Protonmail, Hotmail, etc...

Un client mail, lui, vous permet de lire ces mails. La plupart des hébergeurs fournissent un client webmail et c'est comme cela que vous consultez vos mails, mais vous pouvez aussi utiliser Thunderbird, Evolution, etc. 
</WRAP>
Les avantages d'un client mail autre que celui de votre fournisseur par défaut :
  * Vous pouvez avoir plusieurs comptes mails consultables depuis le même endroit
  * L'interface est différente, ce qui peut être plus confortable (ou pas), apporter d'autres fonctionnalités...

Le logiciel est basé sur Snappymail ; vous trouverez la documentation officielle (en anglais) sur https://snappymail.eu/

Les gros avantages de Snappymail :
  * Un seul identifiant pour relever vos messages chez divers fournisseurs
  * Interface agréable. Si notre superbe thème ne vous plait pas, il y a tout un choix et... on peut en faire d'autres sur demande !
  * Consultable partout, passe aussi bien sur un écran d'ordiphone que sur un écran immense.
  * Paramétrage de filtre SIEVE (si supporté par votre fournisseur)
  * Et plein d'autres détails.

===== Condition d'utilisation du service =====
Là, c'est un peu particulier.

Il est probable que ça ne nous prenne pas trop de ressources mémoires ; donc potentiellement, tout le monde pourrait utiliser cette interface. Cela va demander l'épreuve du test !

Par contre, nous devons ajouter les domaines mails manuellement, en tant qu'administratrices. Donc deux possibilités :

  * Soit votre domaine est déjà listé et il suffit de renseigner vos identifiants mails pour vous connecter
  * Soit ce n'est pas le cas et cela demande une intervention de notre part (voir plus bas dans la doc).

Domaines actuellement disponibles :
  * Un certain nombre de domaines personnels (non publics, gérés par une seule personne ayant son propre domaine)

À venir :
  * numenaute.org
  * khaganat.net
  * gmail et autre gafams ?


===== Pour les utilisateurs de base =====
<WRAP center round todo 60%>
Explication pour les noobs, à compléter, afin que même quelqu'un qui n'est pas doué avec l'informatique puisse s'approprier le service. Si vous avez des liens vers des tutos vidéos, ajoutez-les ! 
</WRAP>
==== Demander l'ajout d'un domaine ====
Il nous faut un certain nombre d'informations (données par votre fournisseur) :
  * Adresse du serveur IMAP et SMTP. Facultatif : Celle du SIEVE
  * Pour chacun, type de connexion (SSL/TLS ou STARTTLS) et le port associé 
  * Un compte mail pour vérifier que tout marche
    * Soit vous passez en présentiel, on configure ensemble, vous testez avec vos identifiants habituels
    * Soit vous avez possibilité de nous faire un compte temporaire chez le fournisseur, le temps du test
    * Soit vous mettez un mot de passe autre sur votre compte habituel, que vous nous passerez, puis vous le changerez à nouveau après le test et la validation du domaine. Clairement pas le meilleur choix mais dans un certain nombre de cas il n'y aura peut-être pas trop d'autres possibilités...

===== Pour les utilisateurs avancés =====
<WRAP center round todo 60%>
Les trucs un peu compliqués que permet le logiciel, ou qui sont accessibles avec des droits précis.
</WRAP>

===== Pour les administrateurs de Numenaute =====
<WRAP center round todo 60%>
Infos pour gérer un service similaire.
</WRAP>
==== Changer le thème et voir les changements ====
C'est assez simple, on ne touche qu'aux couleurs et images si possible. La doc est [[https://github.com/the-djmaze/snappymail/wiki/Custom-Themes|là]].
<WRAP center round important 60%>
Il faut mettre le thème sur ''/var/www/[snappymail]/themes'' et non dans ''/var/www/[snappymail]/v/[version]/themes/'' sinon ça saute lors des mises à jour. Adaptez les chemins bien sûr...
</WRAP>


Par contre il y a un cache et faut le régénerer à chaque changement.
  sudo rm -r /var/opt/snappyprivate/data/_data_/_default_/cache && sudo nginx -s reload

==== Trouver les logs ====
En principe, si on a suivi les instructions d'installation, on a mis les infos ailleurs que dans /var/www. C'est fort probablement dans /var/opt/snappyprivate/log. 

{{tag>Brouillon Documentation}}