\u00a0<\/p>\n<\/p>\n
Mattermost is an open-source platform for team communication. This guide will walk you through installing Mattermost with Nginx as a reverse proxy and securing it with a free SSL certificate from Let’s Encrypt on Ubuntu 24.04.<\/p>\n
sudo<\/code> privileges<\/li>\n- Domain name pointing to your server’s IP address<\/li>\n<\/ul>\n
Step 1: Update the System<\/h2>\n
Start by updating your package list and upgrading your installed packages:<\/p>\n
sudo apt update\r\nsudo apt upgrade -y<\/code><\/pre>\nStep 2: Install Required Dependencies<\/h2>\n
Install dependencies required for Mattermost and Nginx:<\/p>\n
sudo apt install -y nginx postgresql postgresql-contrib<\/code><\/pre>\nStep 3: Install Mattermost<\/h2>\n
Download the latest Mattermost server from the official website:<\/p>\n
wget https:\/\/releases.mattermost.com\/$(wget -qO- https:\/\/api.github.com\/repos\/mattermost\/mattermost-server\/releases\/latest | grep tag_name | cut -d '\"' -f 2)\/mattermost-server-*.tar.gz<\/code><\/pre>\nExtract Mattermost:<\/p>\n
tar -xvzf mattermost-server-*.tar.gz<\/code><\/pre>\nMove the Mattermost folder to the appropriate location:<\/p>\n
sudo mv mattermost \/opt\/<\/code><\/pre>\nStep 4: Configure PostgreSQL Database<\/h2>\n
Log into PostgreSQL and create a new database and user for Mattermost:<\/p>\n
sudo -u postgres psql<\/code><\/pre>\nRun the following commands in the PostgreSQL shell:<\/p>\n
CREATE DATABASE mattermost_db;\r\nCREATE USER mattermost_user WITH PASSWORD 'your_password';\r\nGRANT ALL PRIVILEGES ON DATABASE mattermost_db TO mattermost_user;\r\n\\q<\/code><\/pre>\nStep 5: Configure Mattermost<\/h2>\n
Edit the Mattermost configuration file:<\/p>\n
sudo nano \/opt\/mattermost\/config\/config.json<\/code><\/pre>\nUpdate the following settings:<\/p>\n
\"DriverName\": \"postgres\",\r\n\"DataSource\": \"mattermost_user:your_password@tcp(localhost:5432)\/mattermost_db?sslmode=disable\",<\/code><\/pre>\nAlso set the SiteURL<\/code> to your domain:<\/p>\n\"SiteURL\": \"https:\/\/your_domain.com\",<\/code><\/pre>\nStep 6: Start Mattermost<\/h2>\n
Start the Mattermost server:<\/p>\n
cd \/opt\/mattermost\/bin\r\nsudo .\/mattermost <\/code><\/pre>\nTo run Mattermost in the background, you can use screen<\/code> or set it up with a service file.<\/p>\nStep 7: Install Nginx<\/h2>\n
Start Nginx and enable it to run on boot:<\/p>\n
sudo systemctl start nginx\r\nsudo systemctl enable nginx<\/code><\/pre>\nStep 8: Configure Nginx as a Reverse Proxy<\/h2>\n
Create a new Nginx configuration file for Mattermost:<\/p>\n
sudo nano \/etc\/nginx\/sites-available\/mattermost<\/code><\/pre>\nEnter the following configuration:<\/p>\n
server {\r\n listen 80;\r\n server_name your_domain.com;\r\n\r\n location \/ {\r\n proxy_pass http:\/\/localhost:8065;\r\n proxy_http_version 1.1;\r\n proxy_set_header Upgrade $http_upgrade;\r\n proxy_set_header Connection 'upgrade';\r\n proxy_set_header Host $host;\r\n proxy_cache_bypass $http_upgrade;\r\n }\r\n}<\/code><\/pre>\nEnable the configuration:<\/p>\n
sudo ln -s \/etc\/nginx\/sites-available\/mattermost \/etc\/nginx\/sites-enabled\/<\/code><\/pre>\nTest the Nginx configuration:<\/p>\n
sudo nginx -t<\/code><\/pre>\nRestart Nginx:<\/p>\n
sudo systemctl restart nginx<\/code><\/pre>\nStep 9: Install Certbot for Let’s Encrypt SSL<\/h2>\n
Install Certbot:<\/p>\n
sudo apt install certbot python3-certbot-nginx<\/code><\/pre>\nStep 10: Obtain a Free SSL Certificate<\/h2>\n
Run Certbot to get your SSL certificate:<\/p>\n
sudo certbot --nginx -d your_domain.com<\/code><\/pre>\nFollow the instructions to complete the SSL setup. Certbot will automatically configure Nginx to use the new certificate.<\/p>\n
Step 11: Test HTTPS Access<\/h2>\n
Open your browser and navigate to https:\/\/your_domain.com<\/code> to verify that Mattermost is accessible over HTTPS.<\/p>\nConclusion<\/h2>\n
You have successfully installed Mattermost with Nginx as a reverse proxy and secured it with a Let’s Encrypt SSL certificate on Ubuntu 24.04.<\/p>\n
Resources<\/h2>\n