Mattermost: Premiers pas

Comment débuter avec Mattermost

Bienvenue sur la documentation de Stackhero

Stackhero propose un environnement Mattermost cloud prêt pour la production, conçu pour une collaboration fluide et une protection renforcée des données. Les principaux avantages incluent :

  • Utilisateurs et canaux illimités pour accompagner la croissance de votre équipe sans contrainte.
  • Un serveur SMTP email dédié sans limite supplémentaire, inclus par défaut.
  • Contrôle total de votre nom de domaine, sécurisé automatiquement avec HTTPS (par exemple https://chat.votre-entreprise.com).
  • Mises à jour simplifiées, gérées en un clic.
  • Performance élevée et sécurité avancée sur une infrastructure privée et dédiée : vos données restent isolées et confidentielles.
  • Hébergement disponible dans les régions 🇪🇺 Europe et 🇺🇸 USA.

Il suffit de quelques minutes pour démarrer. Stackhero prend en charge l'installation, la sécurité et la gestion opérationnelle de votre hébergement Mattermost cloud, vous offrant une plateforme de collaboration sécurisée et évolutive avec un minimum d'efforts.

Par défaut, Mattermost envoie des notifications push qui affichent le nom d'utilisateur de l'expéditeur et le canal où le message a été envoyé, sans révéler le contenu du message. Si vous souhaitez inclure l'intégralité du message dans la notification, vous pouvez modifier ce paramètre dans la System Console :

  1. Ouvrez la System Console.

  2. Accédez à Site Configuration > Notifications > Push Notification Contents.

  3. Choisissez d'envoyer uniquement le nom de l'expéditeur, le nom de l'expéditeur avec le canal, ou le message complet.

Options de notification pushOptions de notification push

Pour aller plus loin, le CLI mmctl offre des outils puissants pour gérer et configurer votre instance Mattermost. Vous trouverez plus de détails dans la documentation officielle : https://docs.mattermost.com/manage/mmctl-command-line-tool.html.

Vous pouvez installer mmctl sur votre ordinateur ou l'exécuter via Docker. Nous recommandons l'utilisation de Docker. Pour lancer un conteneur avec un shell bash interactif, exécutez :

docker run -it mattermost/mattermost-team-edition:latest /bin/bash

Pour vous connecter, établissez une connexion avec votre serveur en exécutant :

mmctl auth login -n stackhero https://<XXXXXX>.stackhero-network.com

Vous serez invité à saisir vos identifiants Mattermost. Une fois connecté, vous pouvez effectuer différentes tâches d'administration avec le CLI mmctl.

Si vous utilisez l'authentification à deux facteurs et que vous rencontrez l'erreur "could not initiate client: Invalid MFA token", ajoutez votre token MFA (le code à 6 chiffres de votre application MFA) en exécutant :

mmctl auth login -n stackhero --mfa-token <XXXXXX> https://<XXXXXX>.stackhero-network.com

Après authentification, vous pouvez par exemple lister tous les utilisateurs Mattermost avec la commande suivante :

mmctl user list

Soyez vigilant : cette action supprimera définitivement l'utilisateur et toutes ses données associées, sans possibilité de récupération.

Vous pouvez désactiver un utilisateur depuis la System Console de Mattermost, mais la suppression doit être effectuée via le CLI mmctl. Pour supprimer un utilisateur, exécutez :

mmctl user delete [email protected]

Si vous obtenez l'erreur "Permanent user deletion feature is not enabled. Please contact your System Administrator", activez la suppression d'utilisateur via l'API avec :

mmctl config set ServiceSettings.EnableAPIUserDeletion true

Vous pouvez supprimer un canal en utilisant le CLI mmctl.

Soyez vigilant : cette action supprimera définitivement le canal et toutes ses données, sans possibilité de récupération.

Pour supprimer un canal, remplacez <TEAM> et <CHANNEL> par vos valeurs spécifiques et exécutez :

mmctl channel delete <TEAM>:<CHANNEL>

Si vous obtenez l'erreur Permanent channel deletion feature is not enabled. Please contact your System Administrator., activez cette fonctionnalité en exécutant :

mmctl config set ServiceSettings.EnableAPIChannelDeletion true

Stackhero propose la Team Edition, qui est la version gratuite et open-source de Mattermost. Vous pouvez également acheter une licence Enterprise Edition auprès de Mattermost Inc. et l'utiliser sur Stackhero.

Si vous avez activé par inadvertance la Mattermost Enterprise Edition, vous pouvez la désactiver en suivant ces étapes :

  1. Vérifiez que l'option Enterprise Edition est désactivée sur le tableau de bord Stackhero. Connectez-vous à votre tableau de bord Stackhero, sélectionnez votre service Mattermost, cliquez sur le bouton Configurer et désactivez l'option Enterprise Edition si elle est activée.

    Option Enterprise edition de Mattermost sur le tableau de bord StackheroOption Enterprise edition de Mattermost sur le tableau de bord Stackhero

  2. Connectez-vous à Mattermost, cliquez sur l'icône du menu en haut à gauche, sélectionnez System Console, puis Edition and License. Enfin, cliquez sur Remove License and Downgrade Server.

Après ces étapes, votre serveur repassera en version gratuite Team Edition.

Suppression de la licence enterprise sur MattermostSuppression de la licence enterprise sur Mattermost

Stackhero propose une fonctionnalité unique permettant de supprimer automatiquement les messages Mattermost après un certain nombre de jours.

Par exemple, vous pouvez définir une conservation des messages pendant 365 jours (1 an) dans les canaux publics et privés, et supprimer automatiquement les messages plus anciens. Cela est très utile pour respecter la législation locale sur la rétention des données ou simplement pour réduire l'espace disque utilisé par votre instance.

Pour cela, rendez-vous sur le tableau de bord Stackhero, sélectionnez votre service Mattermost, cliquez sur le bouton "Configurer" puis configurez la section "Auto-delete posts" selon vos besoins.

Configuration de la suppression automatique des messages MattermostConfiguration de la suppression automatique des messages Mattermost