Wiki source code of Installer Mattermost dans Proxmox
Last modified by Mélodie on 2026/03/02 03:40
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
7.1 | 1 | Installing Mattermost – Memo sheet |
| |
5.1 | 2 | |
| |
7.1 | 3 | ## 1. General principle |
| |
1.1 | 4 | |
| |
7.1 | 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). | ||
| |
1.1 | 7 | |
| |
7.1 | 8 | ## 2. Recommended server type |
| |
1.1 | 9 | |
| |
7.1 | 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). | ||
| |
1.1 | 15 | |
| |
7.1 | 16 | ## 3. Required software components |
| |
1.1 | 17 | |
| |
7.1 | 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. | ||
| |
1.1 | 23 | |
| |
7.1 | 24 | ## 4. Main steps for a "classic" installation (VM or LXC) |
| |
1.1 | 25 | |
| |
7.1 | 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). | ||
| |
1.1 | 32 | |
| |
7.1 | 33 | ## 5. Using Proxmox |
| |
1.1 | 34 | |
| |
7.1 | 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). | ||
| |
1.1 | 40 | |
| |
7.1 | 41 | ## 6. Deployment with Docker |
| |
1.1 | 42 | |
| |
7.1 | 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. | ||
| |
1.1 | 51 | |
| |
7.1 | 52 | ## 7. Complexity level |
| |
1.1 | 53 | |
| |
7.1 | 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). | ||
| |
1.1 | 61 | |
| |
4.1 | 62 | --- |
| |
1.1 | 63 | |
| |
7.1 | 64 | ## References |
| |
5.1 | 65 | |
| |
7.1 | 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/) | ||
| |
6.1 | 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) | ||
| |
7.1 | 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) |