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

📍 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

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

• Migrer de Slack vers Mattermost
• Intégrations webhooks et bots

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