Skip to Content
Last modified by Mélodie on 2026/03/02 04:12
From version Icon 5.1 Icon
edited by Mélodie
on 2026/03/02 04:11
Change comment: There is no comment for this version
To version Icon 6.1
edited by Mélodie
on 2026/03/02 04:12
Change comment: There is no comment for this version

Summary

Details

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