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

Summary

Details

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

Langues / Languages

🇫🇷 Français | 🇬🇧 English