====== The lounge ======

[[https://thelounge.minet.net|https://thelounge.minet.net]] (Connectez-vous avec vos identifiants LDAP)

===== Présentation =====

"The lounge" ou "Thelounge" est un client Web pour IRC.
Ses caractéristiques sont les suivantes:

  * Permet de rester toujours connecté à IRC, thelounge se charge de garder l'historique des discussions sur IRC même lorsque vous n'êtes pas connecté à thelounge 
  * Interface "//responsive//"
  * Tourne avec node.js
  * Gère l'authentification LDAP
  * Sous licence MIT
  * Fork communautaire de [[http://shout-irc.com | Shout]]

c.f.: site officiel [[https://thelounge.chat|https://thelounge.chat]]

===== Installation =====

The Lounge à besoin de:
  * node.js
  * npm

Pour installer The Lounge:
<code>npm -g install thelounge</code>
Pour mettre à jour:
<code>npm -g update thelounge</code>

===== Usage =====
Les commandes sont à lancer en tant que l'utilisateur "thelounge" (c.f.: infra)

<code>
  Usage: thelounge [options] [command]


  Options:

    -v, --version             output the version number
    --home <path>             [DEPRECATED] Use the THELOUNGE_HOME environment variable instead.
    -c, --config <key=value>  override entries of the configuration file, must be specified for each entry that needs to be overriden
    -h, --help                output usage information


  Commands:

    start [options]      Start the server
    config               Edit configuration file located at /var/thelounge/.lounge/config.js.
    install <package>    Install a theme or a package
    uninstall <package>  Uninstall a theme or a package


  Environment variable:

    THELOUNGE_HOME   Path for all configuration files and folders. Defaults to /var/thelounge/.lounge.
</code>



===== Le service =====

Le service systemd <3 <3 se trouve dans /lib/systemd/system/thelounge.service
<code>
[Unit]
Description=The Lounge (IRC client)
After=network.target

[Service]
User=thelounge
Group=thelounge
Type=simple
ExecStart=/usr/bin/thelounge start
ProtectSystem=yes
ProtectHome=yes
NoNewPrivileges=yes
PrivateTmp=yes

[Install]
WantedBy=multi-user.target
</code>

===== L'utilisateur =====

Le service se lance en tant que l'utilisateur "thelounge":
<code>
thelounge:x:107:111:System user for The Lounge (IRC client),,,:/var/thelounge:/bin/false
</code>

Le shell par défaut de l'utilisateur thelounge est /bin/false. Donc si vous voulez lancer des commandes en tant que thelounge:
<code>su - thelounge -s /bin/bash</code>

Le $HOME de thelounge est dans /var/thelounge:
  * Dans /var/thelounge/.lounge se trouve toute la configuration de l'appli Web.
  * Dans /var/thelounge/ssl se trouvent la clé privée et le certificat auto-signé (valable 10 ans) utilisé pour sécuriser les communications dans le vlan 102.

===== HTTPS partout =====

vous <=HTTPS=> revproxy <=HTTPS=> thelounge

===== Monitoring =====

Le monitoring du service est très simple:
  * Template "KVM OS Linux"
  * + un item custom: "thelounge process"

L'item "thelounge process" monitore tout simplement le nombre de processus thelounge qui tourne: 
<code>
proc.num[node, thelounge, all, ^node /usr/bin/thelounge start$]
# nombre de processus "node" lancé par l'utilisateur "thelounge"
# où la commande complète est exactement "node /usr/bin/thelounge start"
</code>
Un trigger WARNING est activé lorsque cet item vaut 0.