Mattermost (clone de slack)

Mattermost est un clone quasi parfait de Slack. En pratique, il est même probablement meilleur: le fait de l'héberger sur votre serveur le rend moins susceptible aux coupures et chûtes de débit qui sont relativement courantes avec la version publique et probablement surchargée de Slack!

Installation

Le plus simple: une "instant app" Scaleway, mais cela requiert un serveur dédié à cette tache (qui pourra cependent servir à d'autres tâches à installer manuellement).

Sinon, voir cette page pour une installation "manuelle" sur un serveur existant.

Administration mattermost

Si la gestion des utilisateurs est désactivée au niveau interface mattermost (sécurisation), il faut se logger sur le serveur et passer par la ligne de commande:

cd /opt/mattermost/bin
./platform <...>

Créer un compte

./platform user create --email Mr.Untel@serveur.fr \
  --username mruntel --password tatatoto --firstname Mr --lastname Untel

Puis utiliser l'interface web pour l'ajouter aux canaux nécessaires

Détruire un compte

./mattermost user delete john@example.com

Pour réinitialiser un mot de passe ou débloquer un compte verrouillé suite à trop d'echec

./platform user password mruntel tatatoto

Pour élever un utilisateur au rang d'administrateur

./mattermost roles system_admin untel

la doc officielle est obsolète, cette commande ne marche plus:

./platform -assign_role -team_name="monequipe" -email="Mr.Untel@serveur.fr" --role="system_admin"

Divers

Journaux et erreurs

Un utilisateur ne recevra pas d'alertes email s'il n'a pas validé son email! On peut s'apercevoir du problème via

grep "address not verified" /opt/mattermost/logs/mattermost.log  # verbeux
sed -n 's/.*address not verified....//p' /opt/mattermost/logs/mattermost.log|uniq  # court

Pour voir un log par défaut au format JSON:

jq '.ts |= strftime("%Y-%m-%d %H:%M")' /opt/mattermost/logs/mattermost.log

Notre: si le service s'arrete inopinément après une màj de la base de données sous-jacente, ajouter WantedBy=postgresql.service à la section [Install] de /lib/systemd/system/mattermost.service (ref.).

Voir aussi les scripts mattermost avancés.

Export/import

Source (export):

./mattermost export bulk file.json --all-teams

Source (import):

cd /opt/mattermost/bin/
./mattermost export bulk mattermost-backup.json --validate && ./mattermost export bulk mattermost-backup.json --all-teams