📍 Article principal du cluster : Mattermost 2026 : guide complet.

Trente minutes pour transformer un VPS vide en serveur Mattermost de production. Méthode validée chez plusieurs PME francophones, coût total 4,51 € par mois pour 100 utilisateurs.

Prérequis

Hetzner CX22 minimum (4 Go RAM pour Mattermost + Postgres confortable).
Coolify v4.
Nom de domaine DNS A : chat.votre-entreprise.com.
SMTP (Brevo, Resend) pour invitations.
Niveau attendu : intermédiaire.
Temps estimé : 30-45 minutes.

Étape 1 — DNS et préparation

dig +short chat.votre-entreprise.com  # IP VPS

Étape 2 — Service Mattermost dans Coolify

Resources → + New → Service → rechercher « Mattermost ». Coolify déploie le template officiel avec Postgres 16.

Étape 3 — Variables d’environnement

MM_SERVICESETTINGS_SITEURL=https://chat.votre-entreprise.com
MM_SQLSETTINGS_DATASOURCE=postgres://mmuser:password@mattermost-db:5432/mattermost?sslmode=disable
MM_SERVICESETTINGS_LISTENADDRESS=:8065
MM_FILESETTINGS_DRIVERNAME=local
MM_FILESETTINGS_DIRECTORY=/mattermost/data/

# SMTP
MM_EMAILSETTINGS_SMTPSERVER=smtp-relay.brevo.com
MM_EMAILSETTINGS_SMTPPORT=587
MM_EMAILSETTINGS_SMTPUSERNAME=login
MM_EMAILSETTINGS_SMTPPASSWORD=key
MM_EMAILSETTINGS_FEEDBACKEMAIL=chat@votre-entreprise.com
MM_EMAILSETTINGS_FEEDBACKNAME=Mattermost
MM_EMAILSETTINGS_CONNECTIONSECURITY=STARTTLS

# Push notifications (gratuit Mattermost Cloud Push Service)
MM_EMAILSETTINGS_PUSHNOTIFICATIONCONTENTS=full
MM_EMAILSETTINGS_PUSHSERVER=https://push.mattermost.com

Étape 4 — Domaine HTTPS

Onglet Domains : https://chat.votre-entreprise.com. Force HTTPS ON.

Étape 5 — Lancer Deploy

Coolify pull mattermost/mattermost-team-edition:latest. Comptez 3-5 minutes.

Étape 6 — Premier compte admin

Ouvrir https://chat.votre-entreprise.com. Page de signup. Le premier compte créé devient admin global.

Saisir email, password 14+ caractères, choisir nom utilisateur.

Étape 7 — Créer le team

Workspace → Create team. Nom : « Votre Entreprise », URL slug.

Inviter les premiers membres via email. Ils reçoivent magic link.

Étape 8 — Channels initiaux

Channels typiques pour PME 25 personnes :

#general : tout le monde, annonces.
#random : décompression.
#dev : équipe technique.
#marketing : équipe marketing.
#alerts : webhooks Grafana, Forgejo, Uptime Kuma.
#client-X (privé) : par projet client.

Étape 9 — Activer Calls plugin

System Console → Plugins → Calls → Enable. Configuration : default 8 participants, recording disabled (Team Edition).

Étape 10 — Apps mobiles

Distribuer aux collaborateurs : iOS App Store « Mattermost », Android Play Store / F-Droid. Configuration : Settings → Server → URL https://chat.votre-entreprise.com.

Étape 11 — Sauvegardes

# Cron quotidien
docker exec mattermost-db pg_dump -U mmuser mattermost | gzip > /tmp/mm-pg.gz
restic backup /tmp/mm-pg.gz /var/lib/coolify/services/mattermost-prod/data
rm /tmp/mm-pg.gz

Erreurs fréquentes

Erreur	Cause	Solution
Mattermost crash boot	Postgres pas prêt	Augmenter timeout health check
Email invitation non reçu	SMTP pas testé	System Console → Email → Test
Push mobile silencieux	PushServer mal configuré	Vérifier `https://push.mattermost.com`
Upload fichiers échoue	Disk plein	Configurer S3 storage
WebSocket déphasé	Caddy pas WS	Vérifier `reverse_proxy 8065`
Recherche lente	Postgres FTS uniquement	Ajouter Elasticsearch (Enterprise)

Adaptation au contexte ouest-africain

Trois précisions. Push Service gratuit : Mattermost offre push gratuit jusqu’à 100 utilisateurs. Au-delà, push self-hosted via APNs/FCM. Bande passante : 100 users actifs consomment ~ 100 Mo/jour bandwidth. Hetzner CX22 limit 20 To/mois, large marge. Backups critiques : conversations = mémoire institutionnelle, restic + B2 obligatoire 6h fréquence.

Tutoriels frères

FAQ

Team Edition vs Enterprise ? Team Edition open source illimité users. Enterprise (10 USD/user/mois) ajoute SSO SAML, compliance avancée, support 24/7.

Performance limites ? 5 000 users actifs sur CCX23. 50 000 sur cluster.

Storage S3 ? Recommandé pour > 50 Go fichiers. MinIO, Backblaze B2, AWS S3.

Mises à jour ? Coolify Pull image + Redeploy. Postgres migration auto.

Multi-team ? Une instance Mattermost peut héberger plusieurs teams (clients ESN par exemple).

Pour aller plus loin

🔝 Retour au pilier : Guide complet Mattermost 2026
Documentation : docs.mattermost.com/install

Déployer Mattermost sur Coolify avec Postgres : tutoriel complet 2026