Skip to Content
Last modified by Mélodie on 2026/03/02 03:40
Show last authors
1 Installing Mattermost – Memo sheet
2
3 ## 1. General principle
4
5 * Installation suited for an administrator comfortable with Linux (command line, services, reverse proxy).
6 * Runs on a Linux server (VM, LXC, bare-metal, or via Docker containers).
7
8 ## 2. Recommended server type
9
10 * OS: 64-bit Linux (Ubuntu/Debian recommended).
11 * Possible platforms:
12 * VPS or dedicated server at a hosting provider.
13 * Self-hosted server (with port forwarding + DNS).
14 * Virtualized environment such as Proxmox (VM or LXC).
15
16 ## 3. Required software components
17
18 * System: Linux server distribution (Ubuntu 18.04+ or equivalent).
19 * Database: PostgreSQL (recommended) or MySQL/MariaDB.
20 * Web server / reverse proxy: Nginx or Apache.
21 * TLS certificates: Let's Encrypt via Certbot or equivalent (for HTTPS).
22 * System service: systemd unit or equivalent to start Mattermost at boot.
23
24 ## 4. Main steps for a "classic" installation (VM or LXC)
25
26 1. Update the system and install required packages (PostgreSQL/MySQL, Nginx/Apache, utilities).
27 1. Create the database and dedicated SQL user for Mattermost.
28 1. Download and extract the Mattermost archive to a directory (e.g. `/opt/mattermost`).
29 1. Configure `config.json` (site URL, DB connection, ports, basic options).
30 1. Create a dedicated system user and a systemd unit for the Mattermost service.
31 1. Configure Nginx/Apache as a reverse proxy to Mattermost, enable HTTPS (Let's Encrypt).
32
33 ## 5. Using Proxmox
34
35 * Options:
36 * Linux VM (Ubuntu/Debian) with classic installation.
37 * Linux LXC container with classic installation.
38 * VM or LXC "Docker host" on which Mattermost is deployed via Docker.
39 * Scripts or LXC templates are available to deploy Mattermost directly in Proxmox (automated pre-configuration).
40
41 ## 6. Deployment with Docker
42
43 * Available images:
44 * Mattermost server (dedicated image, often used with docker-compose).
45 * PostgreSQL (official `postgres` image).
46 * Nginx reverse proxy (official `nginx` image) or equivalents (Traefik, Nginx Proxy Manager).
47 * Typical `docker-compose` setup:
48 * `mattermost-app` service (application).
49 * `db` service (PostgreSQL).
50 * `reverse-proxy` service (Nginx/Traefik) exposed on 80/443.
51
52 ## 7. Complexity level
53
54 * Reasonable for an administrator comfortable with:
55 * Service management (systemd).
56 * Database configuration.
57 * Reverse proxy and TLS certificates.
58 * Simpler with:
59 * A step-by-step tutorial adapted to the distribution.
60 * Pre-configured scripts or containers (Proxmox helper scripts, Docker stacks).
61
62 ---
63
64 ## References
65
66 * [How to install Mattermost on Ubuntu](https://alexhost.com/fr/faq/how-to-install-mattermost-on-ubuntu/)
67 * [A decentralized communication server with Mattermost](https://www.magentix.fr/blog/un-serveur-de-communication-decentralise-avec-mattermost.html)
68 * [How to install Mattermost on a Gandi Cloud Server](https://docs.gandi.net/fr/cloud/tutoriels/mattermost.html)
69 * [Install Mattermost with Docker](https://technonagib.fr/installer-mattermost-docker/)
70 * [Preparations – Mattermost Deployment Guide](https://docs.mattermost.com/deployment-guide/server/preparations.html)
71 * [Install Mattermost](https://mattermost.com/install/)
72 * [Mattermost Deployment Guide](https://docs.mattermost.com/guides/deployment.html)
73 * [Install Mattermost on AlwaysData](https://help.alwaysdata.com/fr/guides/mattermost/)
74 * [Install Mattermost with Docker – video](https://www.youtube.com/watch?v=JbfQvWVV_NE)
75 * [Install Mattermost in Proxmox VE – Proxmox Helper Scripts](https://community-scripts.github.io/ProxmoxVE/scripts?id=mattermost)

Langues / Languages

🇫🇷 Français | 🇬🇧 English