[Tuto] Installation de The Lounge en Docker

[EVO]

[Tuto] Installation de The Lounge en Docker​

The Lounge c'est quoi ?
The Lounge est un client Web pour chat IRC.

Envie de tester ? https://demo.thelounge.chat/

Disclamer :
Le but de ce tuto sera de rendre cette installation facile et accessible a tous, bien que loin d’être un expert de docker/docker compose, n’hésiter pas à répondre à ce sujet avec vos interrogations, .. Pour ceux qui sont plus a l'aise avec ce genre d'installation, n'hésiter pas a proposer des améliorations, ou des conseils, ...

Pour un support sur The Lounge ne concernant pas une installation via ce tutoriel, merci de poster votre question dans Applications.

Pré-requis :
Avoir Docker et Docker Compose installé sur sa machine.
Ce connecter en SSH à votre Serveur/NAS, si vous ne savez pas le faire, vous trouverez ici un tuto explicatif : [Tuto] Acceder à son NAS en lignes de commande.

A modifier selon votre installation :
Toute mon installation, va ce faire dans un dossier partagé "docker"
Je vais donc installer The Lounge dans /docker/thelounge
Les PUID/PGID de mon compte utilisateur sont : PUID=1000 PGID=100 **

** Pour connaitre le PUID/GUID de l'utilisateur : [Tuto] Connaitre le PUID / PGID d'un utilisateur.

Sommaire :
1/ Créer les dossiers nécessaires
2/ Configuration et Création du fichier "docker-compose.yml"
3/ 1er démarrage du conteneur
4/ Configuration de The lounge

a/ Rendre l'instance privée​

b/ Rajouter un utilisateur​

5/ Accès a l'interface


Aller go

---

1/ Créer les dossiers nécessaires
Sur le NAS nous allons devoir créer un dossier thelounge contenant un dossier config/ ce dernier contiendra tous les fichiers de configuration nécessaire au fonctionnement de The Lounge.

Rendez vous dans votre dossier docker, avec la commande cd, par exemple si votre dossier docker est dans /volume1 alors la commande sera :
cd /volume1/docker

Puis, exécuter cette commande pour créer les dossiers nécessaires à The Lounge : mkdir -p thelounge/config

Ensuite, avec la commande cd thelounge, rendez-vous dans le dossier principal de The lounge que nous venons de créer.

Note : A partir de maintenant, toute les commandes du tutoriel partirons du principe que vous les exécuter depuis le dossier /thelounge

---

2/ Configuration et Création du fichier "docker-compose.yml"

Sur votre ordinateur, créer un fichier docker-compose.yml, copier dedans le contenu suivant :

---
version: "2.1"
services:
  thelounge:
    image: lscr.io/linuxserver/thelounge
    container_name: thelounge
    environment:
      - PUID=1000
      - PGID=100
      - TZ=Europe/Paris
    volumes:
      - ./config>:/config
    ports:
      - 4040:9000
    restart: unless-stopped

Vous devez modifier[/I][/U] :
- PUID=1000, à modifier avec le PUID de votre utilisateur
- PGID=100, à modifier avec le PUID de votre utilisateur

Note : J'ai volontairement modifié le port 9000 par defaut de The Lounge, car c'est également celui utilisé par Portainer.

Une fois tous ceci modifié, on enregistre le fichier docker-compose.yml, et on le transfert sur le nas dans notre dossier thelounge.

3/ 1er démarrage du conteneur
Toujours en SSH, et depuis notre dossier thelounge :

On lance la création du conteneur :

docker compose up -d

Note : Si vous utilisez la version 1 de docker-compose, alors la commande est docker-compose up -d .

Une fois le lancement fini thelounge a créer ses fichiers de configuration dans le dossier config, nous allons stopper le conteneur, et passer a la configurations des ces derniers.

Pour stopper le conteneur :

docker compose stop

[/SIZE]

Note : Si vous utilisez la version 1 de docker-compose, alors la commande est docker-compose stop .

4/ Configuration de The lounge
a/ Rendre l'instance privée

Toujours en SSH, et depuis notre dossier thelounge :

Nous allons configurer The Lounge pour etre "privé", l'acces sera donc uniquement reservé aux utilisateurs enregistré !
Pour cela, on edite le fichier config.js :
nano config/config.js

On recherche :

public: true

On le remplace par :

public: false

Puis on quitte en enregistrant les modifications. On peut maintenant, relancer notre conteneur :

docker compose up -d

b/ Rajouter un utilisateur
Toujours en SSH,

Pour rajouter un utilisateur, voici la commande a executer :

docker exec -it thelounge s6-setuidgid abc thelounge add <user>

<user> est a remplacer par le nom d'utilisateur voulu.

Par exemple, pour le nom d'utilisateur Cachem, la commande sera :

docker exec -it thelounge s6-setuidgid abc thelounge add Cachem

Le terminal vous demandera de choisir un mot de passe et si vous souhaitez enregistrer les logs ( par defaut : oui ).

5/ Accès a l'interface

- L’accès au service se fait via une WebUI ( Interface Web ), sur un port qui lui est propre.
- Pour The Lounge, c'est le port 4040. Donc l'adresse sera sous la forme : http://IP_DE_LA_MACHINE:4040
Exemple : Si l'adresse IP de votre machine est 192.168.1.10, alors l'adresse d'accès sera : http://192.168.1.10:4040