WikiMiNET

La documentation technique et administrative

Outils pour utilisateurs

Outils du site


wiki:services:thelounge

The lounge

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 Shout

c.f.: site officiel https://thelounge.chat

Installation

The Lounge à besoin de:

  • node.js
  • npm

Pour installer The Lounge:

npm -g install thelounge

Pour mettre à jour:

npm -g update thelounge

Usage

Les commandes sont à lancer en tant que l'utilisateur “thelounge” (c.f.: infra)

  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.

Le service

Le service systemd <3 <3 se trouve dans /lib/systemd/system/thelounge.service

[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

L'utilisateur

Le service se lance en tant que l'utilisateur “thelounge”:

thelounge:x:107:111:System user for The Lounge (IRC client),,,:/var/thelounge:/bin/false

Le shell par défaut de l'utilisateur thelounge est /bin/false. Donc si vous voulez lancer des commandes en tant que thelounge:

su - thelounge -s /bin/bash

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:

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"

Un trigger WARNING est activé lorsque cet item vaut 0.

wiki/services/thelounge.txt · Dernière modification: 2020/06/27 18:16 (modification externe)