{"id":2978,"date":"2025-03-25T12:46:33","date_gmt":"2023-03-24T04:20:24","guid":{"rendered":""},"modified":"2025-02-02T00:46:19","modified_gmt":"2025-02-01T23:46:19","slug":"how-to-install-mattermost-on-debian-11","status":"publish","type":"post","link":"https:\/\/netcloud24.com\/knowledgebase\/how-to-install-mattermost-on-debian-11\/","title":{"rendered":"Linux VPS & VPS Windows Setup Guide | NetCloud24 Mattermost on Debian 11"},"content":{"rendered":"

\u00a0<\/p>\n<\/p>\n

\n

\u00a0<\/h1>\n<\/header>\n
\n

Mattermost is an open-source messaging platform designed for team collaboration and communication. It is a great alternative to proprietary messaging systems and gives you full control over your data. In this guide, we will show you how to install Mattermost on Debian 11. Whether you’re deploying Mattermost on a local server or a , these steps will help you set up Mattermost for efficient team communication.<\/p>\n

\n

Step 1: Update Your System<\/h2>\n

Before installing any software, it’s a good idea to ensure that your system is up to date. Run the following commands to update your Debian 11 system:<\/p>\n

sudo apt update && sudo apt upgrade -y<\/code><\/pre>\n
Keeping your system updated is critical for security and performance, especially when running it on a VPS Windows VPS Servers<\/a> platform.<\/p>\n<\/section>\n
\n
Step 2: Install PostgreSQL<\/h2>\n
Mattermost requires a database to store its data. We will use PostgreSQL, which is supported by Mattermost. Install PostgreSQL with the following command:<\/p>\n
sudo apt install postgresql postgresql-contrib -y<\/code><\/pre>\n
After installing PostgreSQL, start and enable it:<\/p>\n
sudo systemctl start postgresql\r\nsudo systemctl enable postgresql<\/code><\/pre>\n
Log into PostgreSQL and create a user and database for Mattermost:<\/p>\n
sudo -u postgres psql<\/code><\/pre>\n
CREATE DATABASE mattermostdb;\r\nCREATE USER mmuser WITH PASSWORD 'your_password';\r\nGRANT ALL PRIVILEGES ON DATABASE mattermostdb TO mmuser;\r\n\\q<\/code><\/pre>\n
Replace your_password<\/code> with a strong password of your choice.<\/p>\n<\/section>\n
\n
Step 3: Download and Install Mattermost<\/h2>\n
Download the latest version of Mattermost for Linux. Navigate to the \/opt<\/code> directory and download Mattermost:<\/p>\n
cd \/opt\r\nsudo wget https:\/\/releases.mattermost.com\/7.0.0\/mattermost-7.0.0-linux-amd64.tar.gz<\/code><\/pre>\n
Extract the Mattermost archive:<\/p>\n
sudo tar -xvzf mattermost-7.0.0-linux-amd64.tar.gz<\/code><\/pre>\n
Move the extracted files to a directory and create a data folder:<\/p>\n
sudo mv mattermost \/opt\/mattermost\r\nsudo mkdir \/opt\/mattermost\/data<\/code><\/pre>\n<\/section>\n
\n
Step 4: Configure Mattermost<\/h2>\n
Now configure Mattermost to connect to the PostgreSQL database. Open the configuration file:<\/p>\n
sudo nano \/opt\/mattermost\/config\/config.json<\/code><\/pre>\n
Look for the following lines and update them with your PostgreSQL database information:<\/p>\n
\"DriverName\": \"postgres\",\r\n\"DataSource\": \"postgres:\/\/mmuser:your_password@localhost:5432\/mattermostdb?sslmode=disable&connect_timeout=10\"<\/code><\/pre>\n
Replace your_password<\/code> with the password you set for the PostgreSQL user.<\/p>\n
Save and close the file.<\/p>\n<\/section>\n
\n
Step 5: Create a Mattermost Service<\/h2>\n
To manage Mattermost as a service, create a systemd service file. This will ensure Mattermost starts automatically with the system:<\/p>\n
sudo nano \/lib\/systemd\/system\/mattermost.service<\/code><\/pre>\n
Add the following content to the service file:<\/p>\n
[Unit]\r\nDescription=Mattermost\r\nAfter=network.target\r\n\r\n[Service]\r\nType=simple\r\nUser=mattermost\r\nGroup=mattermost\r\nExecStart=\/opt\/mattermost\/bin\/mattermost\r\nRestart=always\r\nRestartSec=10\r\nWorkingDirectory=\/opt\/mattermost\r\n\r\n[Install]\r\nWantedBy=multi-user.target<\/code><\/pre>\n
Save and exit the file. Reload systemd and start the Mattermost service:<\/p>\n
sudo systemctl daemon-reload\r\nsudo systemctl start mattermost\r\nsudo systemctl enable mattermost<\/code><\/pre>\n<\/section>\n
\n
Step 6: Configure Nginx as a Reverse Proxy (Optional)<\/h2>\n
In production environments, it\u2019s recommended to use Nginx as a reverse proxy for Mattermost. Install Nginx:<\/p>\n
sudo apt install nginx -y<\/code><\/pre>\n
Create a new Nginx configuration file for Mattermost:<\/p>\n
sudo nano \/etc\/nginx\/sites-available\/mattermost<\/code><\/pre>\n
Add the following configuration:<\/p>\n
server {\r\n    listen 80;\r\n    server_name yourdomain.com;\r\n\r\n    location \/ {\r\n        proxy_pass http:\/\/localhost:8065;\r\n        proxy_set_header Host $host;\r\n        proxy_set_header X-Real-IP $remote_addr;\r\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\r\n        proxy_set_header X-Forwarded-Proto $scheme;\r\n    }\r\n}<\/code><\/pre>\n
Enable the configuration and restart Nginx:<\/p>\n
sudo ln -s \/etc\/nginx\/sites-available\/mattermost \/etc\/nginx\/sites-enabled\/\r\nsudo nginx -t\r\nsudo systemctl restart nginx<\/code><\/pre>\n<\/section>\n
\n
Step 7: Access Mattermost<\/h2>\n
You can now access Mattermost by opening your web browser and navigating to http:\/\/yourdomain.com<\/code>. You will see the Mattermost setup page where you can create an admin account and configure your team.<\/p>\n<\/section>\n